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NURULLA AZAMOV 


Abstract. In this work we describe a simple MATLAB based language which allows to create ran¬ 
domized multiple choice questions with minimal effort. This language has been successfully tested at 
Flinders University by the author in a number of mathematics topics including Numerical Analysis, 
Abstract Algebra and Partial Differential Equations. 
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1. Introduction 

This manual gives a description of a special purpose programming language which I named Spike. 
Spike is a language specifically designed to create randomized multiple choice tests in mathematics and 
other subjects. Spike is written and is based on MATLAB. The output of Spike is a lAIj^X file which 
contains an assignment. This presumes that a potential user of Spike is to be familiar to a certain extent 
with both MATLAB and HTeX. 

Spike is free but to use it you have to have MATLAB and HTeX installed in your computer. Since 
university teachers of mathematics and physics normally have MATLAB and HTJ;:]X, in case they decide 
to use Spike it should cost them nothing. 

I wrote the first version of this language for my personal use a few years ago. Obviously, before 
plunging into such a task I browsed the Internet in a hope to find something like this which would be 
easy to learn and easy to use. But I did not find anything like this and hence I decided to write such 
a language myself. I successfully used it in three mathematics topics which I teach and I decided that 
others may find it useful too. 

Before proceeding further, I would like to say that my attitude towards testing knowledge by using 
only multiple choice tests is strongly negative, but as part of knowledge testing process multiple choice 
tests have many advantages among which are cost-effectiveness and absolute unambiguity of the marking 
process. These qualities make multiple choice tests an almost indispensable tool. 

To start with let us consider some simple examples. 
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1.1. Examples. 

1.1.1. Example o/problemi type question. Assume that we wish to test whether a child has learnt how 
to add two-digit numbers. Normally, we would randomly choose two two-digit numbers, for instance 45 
and 83 and ask the child to add them. 

The following Spike-program does something similar. 

<<problemI; 
a={10:99}; 
b={10:99}; 
answer ( ’ $7,d$ ’ , a+b) ; 

@2; a,b; 

Find the sum of numbers $7od$ and $7od.$ 

» 

What does this program do? This program picks up randomly two integer numbers a and b from the 
interval 10..99, for instance, 45 and 83 and prints the text of the question 

Find the sum of numbers 45 and 83. 

Further, the command answer (’$7od$ ’ ,a+b); tells Spike that the correct answer is a + b and so it 
calculates the correct answer 128. To create a multiple choice question we have to pick up, say, four 
incorrect answers. The identifier problemi which follows after the opening spike-bracket << tells Spike 
how to create these four alternative incorrect answers: it picks up another pair of integers a and b 
from the interval 10..99 and adds them to get the first alternative incorrect answer, then it repeats this 
process three more times. Each time Spike checks whether the alternative incorrect answer is new, that 
is, different from previous ones, to ensure that all multiple choice answers are different. Finally, Spike 
randomly permutes these answers. The result of processing the above code is the following piece of ETj^X 
text. 

\problemtype{I} 

\problA{D}{2} 

Find the sum of numbers $74$ and $48.$ 

\medskip\noindent 

(A) \ $120$ \quad 

(B) \ $142$ \quad 

(C) \ $143$ \quad 

(D) \ $122$ \quad 

(E) \ $39$ \quad 

This is a piece of a ETj^X-file. Here \problemtype and \problA are HTj^X commands from the 
preamble of the output HTJ^^X-file which you may define as you wish. The argument {D} of \problA 
indicates that the correct answer is D. The second argument in \probl{D}{2}, that is, the number 2, is 
supposed to show a student how many marks this question is worth. This second argument is taken from 
the at-line. 

All is left to do is to convert this EH^^^X-file into a PDF-file. The following is a piece of this PDE-file. 

1. [2m] Find the sum of numbers 74 and 48. 

(A) 120 (B) 142 (C) 143 (D) 122 (E) 39 

This output can be easily modified by changing definitions of ETJ^^X commands \problemtype and 
\problA. 

1.1.2. Example o/problemR type question. Now assume that we wish to test whether a high school student 
has learnt how to solve quadratic equations. To partially achieve this aim we can use the following code. 
<<problemR; 

a={2:8}; 

b={2:8}; 

c={2:8}; 

x2=(-b+sqrt(b~2+4*a*c))/(2*a); 
answer ( ’ $7o. 3f $ ’ ,x2) ; 

@2; a,b,c; 
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Find the largest root of the quadratic equation $7od x~2 + "/d x - 7,d = 0.$ 

Present this root with five digits after the decimal point. 

» 

The following is a piece of MEX-file produced by this Spike-code. 

\problemtype{R} 

\problA{D}{2} 

Find the largest root of the quadratic equation $5 x~2 +7x-5=0.$ 

Present this root with five digits after the decimal point. 

\medskip\noindent 

(A) \ $0.52060$ \quad 

(B) \ $0.52062$ \quad 

(C) \ $0.52064$ \quad 

(D) \ $0.52066$ \quad 

(E) \ $0.52068$ \quad 

\problemtype{R} 

\problA{A}{2} 

Find the largest root of the quadratic equation $2 x~2 +5x-3=0.$ 

Present this root with five digits after the decimal point. 

\medskip\noindent 

(A) \ $0.50000$ \quad 

(B) \ $0.50002$ \quad 

(C) \ $0.50004$ \quad 

(D) \ $0.50006$ \quad 

(E) \ $0.50008$ \quad 

The following is a piece of processed PDF file. 

2. [2m] Find the largest root of the quadratic equation 5a;^ + 7x — 5 = 0. Present this root with five digits 
after the decimal point. 

(A) 0.52060 (B) 0.52062 (C) 0.52064 (D) 0.52066 (E) 0.52068 

3. [2m] Find the largest root of the quadratic equation 2x‘^ -F 5a; — 3 = 0. Present this root with five digits 
after the decimal point. 

(A) 0.50000 (B) 0.50002 (C) 0.50004 (D) 0.50006 (E) 0.50008 

The difference between type I and type R problems is in the way Spike creates alternative incorrect 
answers. (In the third question above the answers are not good, of course) 

2. How DOES SpIk£ work? 

2.1. How to obtain Spike code? Until 1st of September 2015 you can email me requesting the spike 
code. Please write in the subject of your email “request for spike code”. You will get an automatic reply 
with spike m-files attached. 

Another option is to copy-paste the spike-code given in Appendix B. 

2.2. Installing Spike . There is no setup program which could install Spike in your computer, so it 
should be installed manually. Fortunately, this is not difficult. In addition, as Jamie Oliver once said, an 
advantage of cooking your own meal is that you know exactly what ingredients are in it. 

To instal Spike, carry out the following steps: 

(1) In MATLAB folder MATLAB\ create a new folder and name it Spike\. We shall refer to this folder 
as spike folder. 

(2) Copy files spike.m and topfile.tex into the spike folder. 

(3) Create folder Spike_m_f iles\ in the spike folder. 

(4) Copy the files 

• assignment.m. 
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• datablock.m, 

• problem.m, 

• problemG.m, 

• problemH.m, 

• probleml.m, 

• problemR.m, 

• probleml.m, 

• problemV.m. 

• spikeblock.m, 

• topic.m, 

• ProcessCurvedBrackets.m, 

• ReadSpikeBlock.m, 

• SeparateVariables.m, 

• Spike2Matlab.m, 

into the folder Spike_m_f iles\. 

In order to use Spike the following steps need to be carried out as well: 

(1) Create a folder with topic name in the spike folder. This folder will be called topic folder. 

Normally, university and college topics have topic codes. For example, at Flinders University 
Algebra has topic code MATH2712, Partial Differential Equations has topic MATH3712, etc. I 
usually choose the topic code to name the topic folder. 

(2) Create a file with the list of university ID numbers of students enrolled in the topic. The exact 
format of this file is explained below. 

(3) Create folder Utils\ in the spike-folder. In this folder we shall keep Matlab functions used in 
Spike files. 

2.3. To get started. Spike is a computer program written in MATLAB, and it is executed by MAT- 
LAB’s processor. The aim of this program is to produce a LaTeX file which contains an assignment. 
Once the assignment LaTeX file is ready all that is left to do is to convert it into a PDF file and then 
post it online for students to view. This also means that to use Spike it is absolutely necessary to have 
MATLAB in your computer, but it is not necessary to have LaTeX in it. You need LaTeX if you want 
to do something with the LaTeX file produced by Spike. 

Any assignment has two attributes: assignment’s topic and assignment number. Hence, not surpris¬ 
ingly, Spike has two arguments: topic code and assignment number. Assume that the topic code is 
MATH2712 and the assignment being prepared is the third one. Assuming that all Spike files have been 
properly installed, in MATLAB’s prompt >> you should type the following command: 

»spike ( ’ MATH2712 ’ , 3) 

and then press [Enter] key. 

This will work if 

(1) The current folder is the spike-folder; this is the folder which contains the m-hle spike. m. 

(2) The current folder has a subfolder Spike_m_f iles which contains the following m-files: 
assignment.m, datablock.m, problem.m, problemG.m, problemH.m, probleml.m, problemR.m, 
probleml.m, problemV.m. spikeblock.m, topic.m, ProcessCurvedBrackets .m, 
ReadSpikeBlock.m, SeparateVariables.m, Spike2Matlab.m. 

These files form an integral part of the Spike -code and without any of them Spike will not work. 
A user of Spike do not need to worry about the content of these files. There is one exception: in 
the file topic.m there is code which defines topic names given their topic codes. One may wish 
to change this code or otherwise leave it as it is, since it is not essential anyway. 

(3) The current folder contains a folder whose name coincides with the topic code, that is, MATH2712\. 
This folder will be referred to as topic folder. 

Spike saves the output LaTeX file with the assignment in this folder. The output LaTeX file 
is automatically given a name in the format TopicCodeAN.tex. For example, in our case the 
output file will be named MATH2712A3.tex. 

(4) The topic folder contains a file with a list of students’ ID’s enrolled in the topic. The name of 
this file should have the format TopicCode.txt. For example, in our case there must be a file 



6 


NURULLA AZAMOV 


MATH2712.txt in the topic folder MATH2712\. This file will be referred to as student list file. The 
content of this file can be as follows: 

2006280 

2032971 

2062720 

2084704 


This means that there are four students enrolled in the topic MATH2712 and these are their student 
IDs. As a result, Spike will prepare four assignments. A file with list of students must contain a 

line which starts with “seven dashes”-. Everything which follows after this line is ignored 

by Spike. This is convenient, since if there are say 150 students enrolled in a topic you would not 
prepare 150 assignments every time you test your Spike-code unless everything has been tested 
and the final version of the assignment can be prepared. This is important since Spike works 
extremely slowly: it takes about quarter of a second to prepare one multiple choice question. So, 
if an assignment contains 20 questions and there are about 50 students, it may take Spike a few 
minutes to prepare an assignment. 

For example, I keep all student ID’s in a student list file and insert the second seven dashes line 
after the second or the third student ID, so that Spike prepares only two or three assignments. 
When everything is ready I remove this seven dashes line. 

(5) In the topic folder there is a file which contains the Spike-code for the assignment. The name 
of this file has strict format: TopicCodeAN. spk. For example, in our case the topic folder must 
have a file MATH2712A3. spk. How to create this kind of spk- file is what this manual is about. 

A spike-file consists of spike-blocks <<. . . >>, a spike-bloek is what comes between spike-braekets 
« and >>. 

For example, the following is a piece of an actual spike-code which contains two spike blocks. 

«data; 

p={7,ll,13}-; 
g=randi(p-l,l,3); 
sg=PolyToLaTeXDesc(g); 

» 

«problemI; 

f=randi(p-1,1,2); 
h=randi(p-1,1,2); 
sf=PolyToLaTeXDesc(f); 
sh=PolyToLaTeXDesc(h); 
fh=polyprod(f,h,p); 

[~,r] =DART(fh,g,p) ; 
sr=PolyToLaTeXDesc(r); 

answer (’ $°/,s+\\langle ’/.s \\rangle$\\\\ ’ , sr, sg) ; 

@2,0; sf,sg,sh,sg,p,sg; 

Find the product of elements $’/,s+\langle ’/.s \rangle$ 

and $’/,s+\langle °/,s \rangle$ of the ring $\mbZ_{"/,d} [x]/Mangle "/,s \rangle.$ 

» 

(6) The current folder must have a file with name topf ile .tex. This file will be called top-file. The 
top-file contains assignment information such as (I) due date for the assignment, (2) instructions 
how to answer assignment questions, (3) definitions of DTJ^X commands such as \problA, etc. It 
is up to you what you write in the top-file. 

Before the line \documentclass ... in the top-hle it can also have some MATLAB commands 
initializing certain parameters, such as the maximum mark for the assignment, due date, etc. 
For example, the spike folder in my computer contains the following folders and files: 

MANUAL\ 

MATH2712\ 

MATH3701\ 

MATH3712\ 

Spike_m_files\ 

SpikeMarkX 
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STATOOOOX 
Utils\ 
spike.m 
topfile.tex 

One can infer from this that I teach three topics (actually four, but for Topology I don’t use Spike); 
these topics are Algebra, Numerical Analysis and Partial Differential Equations. 

The following is the content of MATH2712\ folder: 

Final\ 

MATH2712A1.spk 
MATH2712A2.spk 
MATH2712A3.spk 
MATH2712A4.spk 
MATH2712Al.tex 
MATH2712A2.tex 
MATH2712A3.tex 
MATH2712A4.tex 
MATH2712.txt 

One may wonder about the purpose of the folder Final. The thing is that Spike overwrites an old 
spike file if there is one. Hence, if one is absolutely happy with the final version of the assignment and 
the assignment is ready to be posted online for students to view, then it is very desirable if not necessary 
to copy the final version to a secure place where Spike does not poke its nose. The folder Final is that 
secure place. 

2.4. How Spike works? Spike does the following: 

(1) First Spike sets default values of certain parameters. These parameters can be changed in the 
top-file. 

(2) It reads in the topic-data, such as list of student ID’s. 

(3) It creates for writing the out-file TopicCodeAN.tex. 

In our case it is the file MATH2712A3.tex. This file is saved in the topic folder, which is, in our 
case, MATH2712. 

(4) Spike opens the top-file and executes MATLAB commands which precede the line starting with 
\documentc1 ass . 

(5) Spike copies the LaTeX code from the top-file into the out-file. 

(6) And finally, Spike creates the assignment by processing spk-file. 

3. Writing Spike-programs 

3.1. Spike-blocks. In this section we explain how to prepare a spike file. A spike file consists of a 
sequence of spike blocks. A spike block is a text which comes between spike-brackets « and >>. Spike- 
brackets should be placed at the beginning of a line. If << or >> is found somewhere inside a line, then 
it is not considered as a spike-bracket. 

There are three types of spike-blocks: text-blocks, data-blocks and question-blocks. In their turn 
question-blocks can be one of the following six types: I, R, T, G, H and V. 

There are six types of multiple choice questions which Spike can prepare: type I, type R, type T, type 
G, type H and type V. These letters stand for words “integer”, “real”, “true”, “generate” and “verbatim” 
respectively. Each question is prepared by a question-block of the appropriate type. 

A question-block has the format 
<<problemX; 

» 

where X is one of the six letters I, R, T, G, H or V. How to prepare a question-block will be explained 
in subsequent subsections. 

Spike reads a spike file until it encounters the first spike block, processes it and then proceeds reading 
the file until it finds the second spike block, processes it and so on. 

Anything that is placed outside a spike-block is ignored by Spike. Hence, one can use space between 
spike-blocks for comments. 



8 


NURULLA AZAMOV 


3.2. Text-blocks. If a spike-block is a text-block, then Spike copies the content of the block into the 
output LaTeX file. 

A text-block has the format 
<<text; 

(Some text to be written 
into the output file) 

» 

For example, if we are about to prepare a spike-block which creates a question about the Central Limit 
Theorem, then we may write such a text-block: 

<<text; 

\bigskip 

{\bf The Central Limit Theorem.} 

>> 

One can write LaTeX commands in a text-block too, of course. 

3.3. Data-blocks. A data-block has the format 
<<data; 

(Matlab commands defining, say, some variables 
to be used in other spike-blocks) 

» 

In a data block we can define some variables. For example, assume that a question asks to convert a 
number from base 10 to base b. We can define the base & in a data-block as follows: 

<<data; 

b = {2:8}; 

>> 

The command b = {2:8}; assigns to 6 a random value from the interval 2..8. Then the variable b can 
be used in all subsequent spike-blocks, until it is redefined or removed. 

For example, 

<<problemI; 

x={1000:9999}; 

y=Convert_to_base(x,b); 

answer ( ’ Wverb! "/,s ! $_{"/,d}$ \\ ’ ,y ,b) ; 

@2; x,b; 

Convert the number $"/,d$ to base $"/,d.$ 

>> 

In this type I spike-block Convert_to_base is a Matlab function which converts an integer x to base b 
and returns the result as a string in LaTeX format. These kind of Matlab functions used in spike-blocks I 
keep in the folder Utils\, though they can be kept anywhere else. This is what this spike-code produces 
in the output LaTeX file: 

\problemtype{I} 

\problA{D}{2} 

Convert the number $9815$ to base $4.$ 

\medskip\noindent 

(A) \ \verb!1321113!$_{4}$ \ \quad 

(B) \ \verb!122201!$_{4}$ \ \quad 

(C) \ \verb!2012322!$_{4}$ \ \quad 

(D) \ \verb!2121113!$_{4}$ \ \quad 

(E) \ \verb!113101!$_{4}$ \ \quad 

This is the corresponding part of the PDF file: 

4. [2m] Convert the number 9815 to base 4. 

(A) 13211134 (B) I 222 OI 4 (C) 20123224 (D) 21211134 (E) II 3 IOI 4 

This text is a piece of assignment for one of the students. In the next run the value of the variable 
b may change to another, since the command b = {2:8}; will be executed anew. So, the next student 
may get the following question: 
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\problemtype{I} 

\problA-[A}-{2} 

Convert the number $6460$ to base $5.$ 

\medskip\noindent 

(A) \ \verb!201320!$_{5}$ \ \quad 

(B) \ \verb!140214!$_{5}$ \ \quad 

(C) \ \verb! 33402 ! $_{5}-$ \ \quad 

(D) \ \verb!l14242!$_{5}$ \ \quad 

(E) \ \verb!223010!$_{5}$ \ \quad 

5. [2m] Convert the number 6460 to base 5. 

(A) 2013205 (B) 1402145 (C) 334025 (D) 1142425 (E) 2230105 

One may ask why not to define the variable b inside the probleml-block as follows: 

<<problemI; 
b = {2:8}; 
x={1000:9999}; 
y=Convert_to_base(x,b); 
answer ( ’ Wverb! "/,s ! $_{"/,d}$ \\ ’ ,y ,b) ; 

@2; x,b; 

Convert the number $"/,d$ to base $"/,d.$ 

>> 

This is what we get if we do this: 

\problemtype{I} 

\problA{A}{2} 

Convert the number $9895$ to base $2.$ 

\medskip\noindent 

(A) \ \verb!10011010100111!$_{2}$ \ \quad 

(B) \ \verb!12246!$_{7}$ \ \quad 

(C) \ \verb!111110211!$_{3}$ \ \quad 

(D) \ \verb!32054!$_{6}$ \ \quad 

(E) \ \verb!111011121!$_{3}$ \ \quad 

6 . [2m] Convert the number 9895 to base 2. 

(A) IOOIIOIOIOOIII 2 (B) 122467 (C) IIIIIO 2 II 3 (D) 320546 (E) IIIOIII 2 I 3 

3.4. Questions of type I and type R. Questions of types I and R (I for “integer” and R for “real”) 
have the following structure: 

<<problemI; 

(Command part) 
answer(...) ; 

@N1[,N2[,N3]]; [parameters]; [NAltAns;] 

(Text of question) 

» 

or 

<<problemR; 

(Command part) 
answer(...); 

@N1[,N2[,N3]]; [parcuneters]; [NAltAns;] 

(Text of question) 

» 

There is very little difference between type I and type R questions, so we will call them type IR 
questions. 

Here the (Command part) is the command part of a type IR question, N1 is a one-digit number which 
is treated as number of points given for a correct answer to the question, N2 is a one-digit number which 
is treated as number of negative points given for an incorrect answer to the question, and N3 is a one-digit 
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number which is treated as number of negative points given for an unanswered question, (Text of question) 
is text of question which may (in fact, should) contain some randomized variables, and (parameters) are 
parameters of the text part of the question. The parameters N1 and N2 are not compulsory. 

The command part consists of a sequence of MATLAB commands, but some of those commands can 
be special Spike commands which are translated to MATLAB commands by Spike before feeding them 
to MATLAB’s processor. The aim of these commands is 

(1) to randomize certain elements of the multiple choice question, 

(2) to find the correct answer to the question, 

(3) to generate four alternative incorrect answers. 

In current version of Spike all MATLAB commands should be written in one line. For example, you 
can use double-nested for-cycle but you should fit them into a single line. This is a bit inconvenient but 
since one can use MATLAB functions in the command part this is not a big problem. 

The text part of type IR question is the text of the multiple choice question which is typed in lATj^X 
format and some elements of which are replaced by values of variables given in the command part. For 
example, a question asking to add three integer numbers may have the following text part: 

Find the sum of numbers 47, "/d and "/.d. 

This means that the first of these three numbers is not randomized while the other two are. The 
commands "/d and 7od are replaced by values of two variables which are given in the second @-parameter, 
for example, a , b ;. This means that the first number Xd will be replaced by the value of the variable a, 
and the second number will be replaced by the value of the variable b. 

A type I question may look as follows: 

«problemI; 
a={10:99}; 
b={10:99}; 
c=47+a+b; 
answer ( ’ $’/.d$’ , c) ; 

@2,0; a,b; 

Find the sum of numbers 47, °/,d and ’/.d. 

» 

Here a={10:99} ; is a Spike-command which assigns to the variable a an integer value chosen randomly 
from the interval 10..99. In general, if one gives in a Spike-command any list of numbers inside a pair of 
curved brackets {. . .} written in MATLAB format, then Spike replaces that pair of curved brackets by 
a number randomly chosen from the list. For example, an operator of the form 
a = [{3,5,7,11}, {10:-2:2}] 

in one run will be replaced by something like a= [7,10], in another run the same operator will be replaced 
by, say, a=[3,8] etc. Only after this the processed Spike operator will be given to MATLAB’s processor. 
For example, one can use an assignment operator such as a=10{3;7}8; with a result of, say, a=1068. 

The command c=47+a+b; solves the question in the sense that it finds the correct answer. Every type 
IR question must also have “the answer command”; in the above example this is the command 
answer ( ’ $7,d$ ’ , c) ; 

Spike replaces this command by the MATLAB command 
answer=sprintf ( ’ $7od$ ’ , c) ; 

before feeding it to MATLAB’s processor. The meaning of this command should be clear to MATLAB 
users. Thus, the answer command produces a string variable answer which is later printed as one of the 
multiple choice answers. 

Apart of this, a type IR question also produces four alternative incorrect answers. This is where the 
difference between type I and type R questions comes in. To produce incorrect answers Spike runs the 
command part of type I question four more times. Spike makes sure that all the five multiple choice 
answers are different. If the next answer is not “new” then Spike runs the command part again until a 
new answer is produced. If Spike fails to produce a new answer after a certain number of attempts, it 
stops and gives an error message. 

Finally, Spike randomly permutes the five multiple choice answers, but it does not permute the answers 
if the question is of type R, since in this case the multiple choice answers are naturally random. 

Another example of a type I question. 
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«text; 

\bigskip 

\noindent {\bf The Central Limit Theorem} 

»; 

«problemI; 
n={101:300}; 

k=floor(7*n/15) + randi(round(n/15)); 

z=(2*k/n-l)/sqrt(n); 

answer ( ’°/,. 4f ’ ,normcdf (z, 0,1) ) ; 

@2; n,k; 

A fair coin is thrown ’/,d times. 

Find the probability that the number of tails will not exceed °/,d. 

» 

This example consists of two Spike-blocks: text-block and probleml-block. The content of a text-block 
is a piece of I^T[T;X-code which is executed by Spike as it is. A text-block may contain some instructions 
for students on how to solve the problem or it may contain a title, etc. 

The following is what the code above produces: 

\bigskip 

\noindent {\bf The Central Limit Theorem} 

\problemtype{I} 

\problA{E}{2} 

A fair coin is thrown 161 times. 

Find the probability that the number of tails will not exceed 86. 

\medskip\noindent 

(A) \ 0.4992 \quad 

(B) \ 0.4993 \quad 

(C) \ 0.5002 \quad 

(D) \ 0.4984 \quad 

(E) \ 0.5021 \quad 

The Central Limit Theorem 

7. [2m] A fair coin is thrown 161 times. Find the probability that the number of tails will not exceed 86. 
(A) 0.4992 (B) 0.4993 (C) 0.5002 (D) 0.4984 (E) 0.5021 


In a type R question the answer is supposed to be a real number, such as 13.7834801.... In this case 
Spike rounds the answer according to instructions given in the command part and then replaces the last 
digit of the answer by four other digits of the same parity: if the last digit is odd (even) then Spike 
replaces the last digit by odd (even) digits. 

For example, if in the code above we replace problemi by problemR then the result will be different: 

\problemtype{R} 

\problA-[C}{2} 

A fair coin is thrown 123 times. 

Find the probability that the number of tails will not exceed 59. 


\medskip\noindent 

(A) \ $0.4981$\quad 

(B) \ $0.4983$\quad 

(C) \ $0.4985$\quad 

(D) \ $0.4987$\quad 

(E) \ $0.4989$\quad 


8. [2m] A fair coin is thrown 123 times. Find the probability that the number of tails will not exceed 59. 
(A) 0.4981 (B) 0.4983 (C) 0.4985 (D) 0.4987 (E) 0.4989 
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In this case there are two advantages of type R questions compared to type I questions: guessing the 
correct answer by students becomes difficult and the code runs faster. 

Let’s consider another example of a question of type R. 

Question 1. Prevalence of a medical condition in a population is equal to 0.15. What is the prohahility 
that exactly 3 people from a random sample of 9 people chosen from this population have the condition? 

There are three elements of this question which can be randomized: prevalence, the size of random 
sample and the number of people from the sample having the condition. We have to decide how we want 
them to randomize. 

The following Spike-code achieves this aim: 

<<problemR; 

n={7:ll}; 

k={2:5>; 

prvl={9:28}/100; 

p=nchoosek(n,k)*prvl~k*(1-prvl)“(n-k); 
answer ( . 5f ’ ,p) ; 

@3; prvl,k,n; 

Prevalence of a medical condition in a population is equal to "/o.2f. 

What is the probability that exactly "/,d people from a random sample 
of "/od people chosen from this population have the condition? 

>> 

Here the first three commands randomize the three elements of the question, the fourth command 
finds the correct answer and the last command tells Spike to round the answer to five digits after the 
decimal point. 

This is the result: 

XproblemtypefRl 

\problA{D}-[3}- 

Prevalence of a medical condition in a population is equal to 0.22. 

What is the probability that exactly 3 people from a random sample 
of 8 people chosen from this population have the condition? 

\medskip\noindent 

(A) \ $0.17210$ \quad 

(B) \ $0.17212$ \quad 

(C) \ $0.17214$ \quad 

(D) \ $0.17216$ \quad 

(E) \ $0.17218$ \quad 

9. [3m] Prevalence of a medical condition in a population is equal to 0.22. What is the probability that 
exactly 3 people from a random sample of 8 people chosen from this population have the condition? 

(A) 0.17210 (B) 0.17212 (C) 0.17214 (D) 0.17216 (E) 0.17218 


Everything will work in the same way if we replace the identifier problemR by problemi but in this 
case the incorrect answers will be different. 

3.5. Volume of questions of type I and R. With every question of type I or R we can associate a 
positive integer which we shall call random volume or just volume of the question. By definition, the 
volume of a question of type IR is the power of the set of all possible different questions which Spike can 
produce using the question’s code. There is also a second and different way to define the volume: it is the 
power of the set of all possible different answer strings which Spike can produce using the questions code. 
Often there is no difference between these two volumes but in general they are different. To distinguish 
them, we shall call the second volume the answer volume. In any case the volume is always larger than 
or is equal to the answer volume. 

Let’s consider an example. 
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«problemI; 
a={l:6>; 
b={l:6>; 
c=a+b; 

answer ( ’ $"/,d$ ’ , c) ; 

@2,0; a,b; 

Find the sum of numbers "/,d emd "/d. 

>> 

The volume of this question is 36 since each of the variables a and b can take 6 different values and both 
these variables are used in the question’s text. But the set of all possible answers is 2,3,..., 12, and 
hence the answer volume is 11. It is desirable to keep volumes of questions of type IR large enough, say, 
at least 200. This is especially important for questions of type I since very small volumes may slow down 
processing of spike-code considerably. 

3.6. Format of the text part of questions of type I and R. The text part of a question of type 
IR is what comes between at-line and the closing spike-bracket >>. The text part is a plain text written 
in LaTeX format with one exception: the percentage symbol “/« has a special role. In the text part the 
percentage symbol is used as a formatting operator in exactly the same way as in Matlab functions 
fprintf and sprintf. But the percentage symbol should not be the first character of a line in the 
text part, if it is to be used as a formatting operator, since any line in the text part which starts with 
percentage symbol is considered by Spike as a comment and is therefore ignored. If a line starts with 7, 
as a formatting operator then just place the space character before 7.. 

For example, the following spike-block will generate an error message. 

<<problemI; 
a={l:6}; 
b={l:6}; 
c=a+b; 

answer ( ’ $y,d$ ’ , c) ; 

@2,0; a,b; 

Find the sum of numbers 
7od and /.d. 

>> 

To fix the error one can place a space character before 7od or move 7.d to previous line: 

<<problemI; 
a={l:6}; 
b={l:6}; 
c=a+b; 

answer ( ’ $"/,d$ ’ , c) ; 

@2,0; a,b; 

Find the sum of numbers 
y.d and "/.d. 

>> 

or 

<<problemI; 
a={l:6>; 
b={l:6}; 
c=a+b; 

answer ( ’ $y,d$ ’ , c) ; 

@2,0; a,b; 

Find the sum of numbers "/.d 
and y.d. 

>> 

3.7. Questions of type T. A type T question (T for “true”) has the following structure: 

<<problemT; 

7« False statements 
False statement 1 
False statement 2 
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False statement N 


y, True statements 
True statement 1 
True statement 2 

True statement M 
QNl[,N2[,N3]]; k; 

How many of the following assertions are true? 

» 

Here Spike chooses randomly k statements from the list of N+M statements, where the first N statements 
are false and the next M statements are true. True statements should follow after the false ones, and they 

must be separated by seven dash line-. The lines which start with 7„ are comments and are 

ingnored by Spike. Hence, it is not necessary to write “/, False statements and True statements, 
but these lines are a good reminder. 

Let’s consider examples. 

«problemT; 

y. False statements 

Antelope 

Zebra 

Giraffe 

Rabbit 

Hippopotamus 

Elephant 


y. True statements 

Tiger 

Wolf 

Lion 

Cheetah 

Bobcat 

Cat 

Coyote 
@2; 4; 

How many of the following animals are carnivores? 

» 

This is what Spike produces: 

\problemtype{T} 

\problA-[C}-{2} 

How many of the following animals are carnivores? 

\begin{enumerate} 

\item Cheetah 
\item Hippopotamus 
\item Rabbit 
\item Zebra 
\end{enumerate} 

(A) \ 4 \quad 

(B) \ 0 \quad 

(C) \ 1 \quad 

(D) \ 2 \quad 

(E) \ 3 \quad 

10. [2m] How many of the following animals are carnivores? 

(1) Cheetah 

(2) Hippopotamus 

(3) Rabbit 

(4) Zebra 
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(A) 4 (B) 0 (C) 1 (D) 2 (E) 3 


In the next run Spike produces something else: 

\problemtype{T} 

\problA-[C}-{2} 

How many of the following animals are carnivores? 

\begin{enumerate} 

\item Zebra 
\item Cat 
\item Coyote 
\item Elephant 
\end{enumerate} 

11. [2m] How many of the following animals are carnivores? 

(1) Zebra 

(2) Cat 

(3) Coyote 

(4) Elephant 

(A) 1 (B) 3 (C) 2 (D) 0 (E) 4 


Another example. 


«text; 

\bigskip 

\noindent {\bf Properties of $E(X)$ and $\Var(X)$} 

» 


y. Properties of E(X) and VariX) 


«problemT; 
y. False 

$x_l+\ldots+x_n=l.$ 

$E(XY) = E(X)E(Y).$ 

$E(X*2) = [E(X)]~2.$ 

$E(\abs4X}) = \abs4E(X)}.$ 

$E(g(X)) = g(E(X)).$ 

For any real number $c$ \ $\Var(cX) = c\Var(X).$ 
If $c$ is a constant then $E(c) = 0.$ 

If $c$ is a constant then $\Var(c) = c.$ 

$E(X) \geq 0.$ 


y. True 

$p_l+\ldots+p_n=l.$ 

$E(X+Y) = E(X)+E(Y).$ 

For any number $c$ \ $E(cX) = cE(X).$ 

If $c$ is a constant then $E(c) = c.$ 

$E(X) = p_lx_l+\ldots+p_nx_n.$ 

$E(X*2) = p_lx_l~2+\ldots+p_nx_n~2.$ 

$E(g(X)) = p_lg(x_l)+\ldots+p_n g(x_n).$ 

$\Var(cX) = c*2\Var(X).$ 

If $X$ and $Y$ are independent then $E(XY) = E(X)E(Y).$ 

If $X$ and $Y$ are independent then $\Var(X+Y) = \Var(X) + \Var(Y).$ 
For any real number $c$ \ $\Var(cX) = c*2\Var(X).$ 

$\Var(X) = E(X‘2)- [(E(X)]~2.$ 

$\Var(X) \geq 0.$ 

$E(X-2) \geq 0.$ 

If $c$ is a constant then $\Var(c) = 0.$ 

If $\Var(X) = 0$ then $X$ is a constamt random variable. 
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I - 

@1; 8; 

Let $X$ be a random variable which takes values $x_l,\ldo'ts,x_n$ 
and only these values with respective probabilities $p_l,\ldots,p_n,$ 
let $Y$ be another random variable and let $g(x)$ be a function. 

How many of the following assertions are always correct? 

» 

This is what Spike produces in a run: 

\bigskip 

\noindent {\bf Properties of $E(X)$ and $\Var(X)$} 

\problemtype{T} 

\problA{C}-[l}- 

Let $X$ be a random variable which takes values $x_l,\ldo'ts,x_n$ 
and only these values with respective probabilities $p_l,\ldots,p_n,$ 
let $Y$ be another random variable and let $g(x)$ be a function. 

How many of the following assertions are always correct? 

\begin{ enumerate}- 

\item If $c$ is a constant then $\Var(c) = 0.$ 

\item For any number $c$ \ $E(cX) = cE(X).$ 

\item $E(X‘2) = [E(X)]~2.$ 

\item $\Var(X) = E(X~2)- [(E(X)]~2.$ 

\item $E(X) \geq 0.$ 

\item If $X$ and $Y$ are independent then $E(XY) = E(X)E(Y).$ 

\item $E(g(X)) = g(E(X)).$ 

\item $E(X“2) = p_lx_l~2-H\ldots-Hp_nx_n~2. $ 

\end{enumerate}- 

(A) \ 8 \quad 

(B) \ 1 \quad 

(C) \ 5 \quad 

(D) \ 6 \quad 

(E) \ 4 \quad 

Properties of E{X) and Var(X) 

12 . [1 m] Let X be a random variable which takes values xi,..., and only these values with respective 
probabilities pi,... ,p„, let Y be another random variable and let g{x) be a function. How many of the 
following assertions are always correct? 

(1) If c is a constant then Var(c) = 0. 

(2) For any number c E{cX) = cE{X). 

(3) EiX^) = [EiX)]^. 

(4) Var(X) = E{X^) - [{E{X)]^. 

(5) EiX) ^ 0. 

(6) If X and Y are independent then E{XY) = E{X)E{Y). 

(7) EisiX)) = g{E{X)). 

( 8 ) E{X‘^) = Pixl + ... + Pnxl- 

(A) 8 (B) 1 (C) 5 (D) 6 (E) 4 

3.8. Questions of type G. Questions of type G (G for “generate”) are similar to questions of type T. 

The structure of a type G question is this: 

«problemG; 

a_matlab_function_name 
@N1[,N2[,N3]] ; k; 

How many of the following statements are true? 

» 

Here a_matlab_function_naine should be a MATLAB function which returns two variables: a string 
variable which contains a statement in HT)^ format and a false/true variable, which indicates whether 
the statement is false or true. 
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In a question of type T we create a bank of false and true statements related to a certain topic. But 
imagine, for example, that we want to test whether a student has learnt definition of congruence modulo 
an integer. We may ask him/her a question of this kind: “Is it true that 7 = 38 (mod 12).” And we 
can create a bank of false and true statements of this kind for a type T question. There is another way 
to do this: write a MATLAB function, say GetTwoCongruentIntegers which returns two variables: a 
string of the kind 7 = 38 (mod 12) but with randomly chosen numbers and a false/true value which 
shows whether the randomly generated statement is false or true. Once this is done we can create a type 
G question as follows: 

«problemG; 

GetTwoCongruentIntegers 
@1; 4; 

How many of the following congruences are true? 

» 


Spike will run the MATLAB function GetTwoCongruentIntegers four times (as indicated in the 
second parameter of the O-line) to produce four statements counting the number of true statements along 
the way. 

This is what this spike-code produces: 

\problemtype{G} 

\problAlDMl} 

How many of the following congruences are true? 

\begin{enumerate} 

\item $\congruent{108}-[101}-{7}$ 

\item $\congruent{88}-{152}-[8}-$ 

\item $\congruent{31}-{69}-{10}-$ 

\item $\congruent{63}-{75}-{3}$ 

\end{enumerate} 

(A) \ 2 \quad 

(B) \ 0 \quad 

(C) \ 1 \quad 

(D) \ 3 \quad 

13. [1 m] How many of the following congruences are true? 

(1) 108 = 101 (mod 7) 

(2) 88 = 152 (mod 8) 

(3) 31 = 69 (mod 10) 

(4) 63 = 75 (mods) 

(A) 2 (B) 0 (C) 1 (D) 3 

To get an idea of what’s going on let us consider one silly example. 

Write a MATLAB function GetEvenInteger which returns an even or an odd integer with equal 
probability: 

function [s,b]=GetEvenInteger 

y, Returns a random integer s; b is true, if s is even 
y, and b is false if otherwise. 

x=100+ 2 * randi(lOO); 
b=(rand<0.5); 
if ~b, x=x+l; end 
s=sprintf (’ $y,d$ ’ , x) ; 
end 

Then a run of the spike-code 
«problemG; 

GetEvenInteger 
@1; 5; 

How many of the following integers are even? 

» 
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will produce the following output: 

\problemtype{G}- 

\problA{E}-Cl}- 

How many of the following integers are even? 

\begin{ enumerate}- 
\item $120$ 

\item $170$ 

\item $179$ 

\item $271$ 

\item $107$ 

\end{enumerate}- 

(A) \ 1 \quad 

(B) \ 4 \quad 

(C) \ 3 \quad 

(D) \ 5 \quad 

(E) \ 2 \quad 

14. [1 m] How many of the following integers are even? 

( 1 ) 120 

(2) 170 

(3) 179 

(4) 271 

(5) 107 

(A) 1 (B) 4 (C) 3 (D) 5 (E) 2 

3.9. Questions of type H. Questions of type H are very similar to questions of type G, but provide 
more flexibility. 

Let us consider the previous problem: we wish to test whether a student has learnt definition of 
congruence of two integers. In this case question number 10 from previous subsection will solve this 
problem. But imagine that we also wish to test whether a student has learnt definition of congruence 
class of an integer. For example, we may ask a few questions of this type: 

Is it true that 17 € [32]4 
or 

Is it true that [17]4 = [32]4. 

The thing here is that using the same three integers, say a, b and n, we can produce many equivalent 
statements which are true or false at the same time, for example, a = b{ mod n), [a]„ = [6]n, a € [6]„, etc. 
In this case it would be inconvenient to write separate MATLAB functions for three or more questions 
of this kind if we use type G question. 

In type H question the command part has to produce two variables: out and tf (for true/false). The 
first variable out is a string variable which contains in LaTeX format the statement of the question and 
the second variable tf is a boolean variable which indicates whether this statement is true or not. 

The structure of a type H question is this: 

«problemH; 

(Command part) 

@N1[,N2[,N3]] ; k; 

How many of the following statements are true? 

» 

The command part has to produce two variables: out and tf. Spike runs the command part k times 
to generate k statements counting along the way the number of true statements produced. 

Let us consider an example. Assume that we have written a MATLAB function GetCongruentInts 
which returns four variables: three random integer variables a, b and n and one boolean variable tf, 
which has value “true” if and only if n divides a-b. Then the aim of question 10 can be achieved by the 
following code: 

<<problemH; 

[a,b,n,tf]=GetCongruentInts; 

out=sprintf ( ’ $\\congruent{"/od}-["/,d}-{"/od}$ ’ ,a,b,n) ; 
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@1; 4; 

How many of the following statements are true? 

» 

Here we have to write double backslash \\ according to usage of MATLAB’s sprintf function. The 
LaTeX command \congruent can then be defined as one wishes, for example, 
\newcommand{\congruent} [3] {#1 \equiv #2 \ \ (\,\mathrm{mod} \ #3)}. 

This definition can be inserted into the top-file. 

Now using the same function GetCongruentInts we can create other questions. For example, 

«problemH; 

[a,b,n,tf]=GetCongruentInts; 

out=sprintf (’$ [’/.d] _{°/,d}= [’/.d] _{’/.d}$’ ,a,n,b,n) ; 

@1; 4; 

How many of the following statements are true? 

» 

«problemH; 

[a,b,n,tf]=GetCongruentInts; 
out=sprintf (’$°/,d Win [°/.d] _{’/.d}-$ ’ ,a-,b,n) ; 

@1; 4; 

How many of the following statements are true? 

» 

«problemH; 

[a,b,n,tf]=GetCongruentInts; 

out=sprintf (’$ [’/,d] _-[°/,d} Wcap [°/,d] _{’/.d}- = \\emptyset$’,a,n,b,n) ; 

@1; 4; 

How many of the following statements are true? 

» 

This is the result: 

\problemtype{H} 

\problA-[D}-{l} 

How many of the following statements are true? 

\begin{enumerate} 

\item $[106]_{4}=[138]_{4}$ 

\item $[33]_{13}=[181]_{13}$ 

\item $[56]_{3}=[53]_{3}$ 

\item $[119]_{10}=[138]_{10}$ 

\end{enumerate} 

(A) \ 0 \quad 

(B) \ 3 \quad 

(C) \ 4 \quad 

(D) \ 2 \quad 

(E) \ 1 \quad 


\problemtype{H} 

\problA-[C}{l} 

How many of the following statements are true? 
\begin{enumerate} 

\item $44 \in [132]_{7}$ 

\item $112 \in [180]_{5}$ 

\item $113 \in [146]_{3}$ 

\item $35 \in [178]_{13}$ 

\end{enumerate} 


(A) \ 3 \quad 

(B) \ 0 \quad 

(C) \ 2 \quad 

(D) \ 1 \quad 
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(E) \ 4 \quad 

\problemtype{H}- 

\problA{C}-[l}- 

How many of the following statements are true? 

\begin{ enumerate}- 

\item $[78]_{4} \cap [114] _-C4}- = \emptyset$ 

\item $[61]_{3} \cap[98]_{3} = \emptyset$ 

\item $[115]_-C3}- \cap [124] _-[3}- = \emptyset$ 

\item $[115]_{9]- \cap [178] _-[9]- = \emptyset$ 

\end{enumerate]- 

(A) \ 2 \quad 

(B) \ 1 \quad 

(C) \ 3 \quad 

(D) \ 0 \quad 

(E) \ 4 \quad 

15. [1 m] How many of the following statements are true? 

(1) [106]4 = [138]4 

(2) [33]i3 = [181]i3 

(3) [56]3 = [53]3 

(4) [119]io = [138]io 

(A) 0 (B) 3 (C) 4 (D) 2 (E) 1 

16. [1 m] How many of the following statements are true? 

(1) 44 e [132]7 

(2) 112 e [180]5 

(3) 113 e [146]3 

(4) 35 € [178]i3 

(A) 3 (B) 0 (C) 2 (D) 1 (E) 4 

17. [1 m] How many of the following statements are true? 

(1) [78]4 n [114]4 = 0 

(2) [61]3 n [98]3 = 0 

(3) [115]3n[124]3 = 0 

(4) [115]9n[178]9 = 0 

(A) 2 (B) 1 (C) 3 (D) 0 (E) 4 

3.10. Questions of type V. Einally, there are questions of type V (V for “verbatim”). 

A question of type V is not a random question. This type of question is introduced just in case one 
wants to include a non-randomized question into an assignment (why not?). The reason may be that not 
all questions can be randomized. 

The structure of a type V question is as follows: 

<<problemV; 

QNl[,N2[,N3]]; X; 

Write here whatever you want 
but in LaTeX format. 

» 

Here X is the correct answer to the question. Since this is a non-randomized question, the correct 
answer to it is known, and it should be indicated in the @-line as the third parameter. This is necessary 
since Spike keeps all correct answers for marking purposes. 

Let us consider an example. 

<<problemV; 

@2,1; D; 

Which of the following chemical elements is a metal? 

(A) \ $0$ \quad (B) \ $C$ \quad (C) \ $H$ \quad (D) \ $K$ \quad (E) \ $N$ 
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» 

This is what Spike produces: 

\problB{D>{2}{l}- 

Which of the following chemical elements is a metal? 

\medskip 

(A) \ $\mathrm 0$ \quad (B) \ $\mathrm C$ \quad (C) \ $\mathrm H$ 

\quad (D) \ $\mathrm K$ \quad (E) \ $\mathrm N$ 

18. [2m,—Im] Which of the following chemical elements is a metal? 

(A) O (B) C (C) H (D) K (E) N 

The following is an actual type V question from one of the Algebra assignments. 

«problemV; 

@2,2; C; 

Let $X$ be any non-empty set and let $P(X)$ be the family of all subsets of $X.$ 

We endow the set $P(X)$ with binary operations of union $\cup$ as addition 
and intersection $\cap$ as multiplication of sets. 

Thus obtained triple $(P(X), \cup, \cap)$ is not a commutative ring with identity, 

since it fails to meet one of the axioms (Rl)—(R8) 

of a commutative ring $(R,+,\cdot)$ with identity, given below. 

Which axiom is that? 

\begin{enumerate} 

\item[(Rl) \ ] $\forall a,b \in R \ \ a+b= b+a;$ 

\item[(R2) \ ] $\forall a,b,c \in R \ \ (a+b)+c= a+(b+c);$ 

\item[(R3) \ ] $\exists 0_R \in R \ \forall a \in R \ \ a+0_R = a$ and $0_R+a=a;$ 

\item[(R4) \ ] $\forall a \in R \ \exists b \in R \ \ a+b=0_R$ and $b+a=0_R.$ 

\item[(R5) \ ] $\forall a,b,c \in R \ \ (a+b)c= ac+bc$ \quad Euid \quad $c(a+b) = ca+cb.$ 

\item[(R6) \ ] $\forall a,b,c \in R \ \ (ab)c= a(bc).$ 

\item[(R7) \ ] $\exists 1_R \in R \ \forall a \in R \ \ a\cdot 1_R = l_R\cdot a=a.$ 

\item[(R8) \ ] $\forall a,b \in R \ \ ab= ba.$ 

\end{enumerate} 

\par 

(A) \ (R2) \qquad (B) \ (R3) \qquad (C) \ (R4) \qquad (D) \ (R5) 

\qquad (E) \ (R6) \qquad (F) \ (R7) ’/. correct answer is (C) 

» 


19. [2m,—2m] Let X be any non-empty set and let P{X) be the family of all subsets of X. We endow 
the set P{X) with binary operations of union U as addition and intersection n as multiplication of sets. 
Thus obtained triple (P(X),U,n) is not a commutative ring with identity, since it fails to meet one of 
the axioms (R1)-(R8) of a commutative ring {R, -P, •) with identity, given below. Which axiom is that? 

(Rl) ya,b G R a + b = b + a; 

(R2) ya,b,cGR {a + b) + c = a + {b + c); 

(R3) 30_r G R'ia G R a + QR = a and 0 _r -P a = a; 

(R4) \/a G R Bb G R a + b = Or and b + a = Or. 

(R5) Vo, b,c G R (a -P b)c = ac + bc and c{a + b) = ca + cb. 

(R6) ya,b,cGR {ab)c = a{bc). 

(R7) 31/j G R Va G R a ■ \r = 1r • a = a. 

(R8) Va, b G R ab = ba. 

(A) (R2) (B) (R3) (C) (R4) (D) (R5) (E) (R6) (F) (R7) 

This is a good question, but it is difficult to randomize it. 

3.11. Questions of type Z. A question of type Z is not a question. If a spike-block <<...>> starts with 
<<problemZ; then Spike ignores the whole spike-block. This feature is convenient if you wish to remove 
temporarily one or more questions from the assignment, or some question is not ready yet etc. 
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3.12. Top-file. Spike creates an output M^^^X-file which contains one assignment for each student en¬ 
rolled in a topic. In the beginning of this output file it is desirable to give some information relevant to 
the assignment such as: (1) assignment number, (2) due date, (3) the percentage of the total assessment 
which this assignment constitutes, (4) instructions on how to submit answers to the assignment, (5) what 
to do in certain exceptional cases, etc. 

All this information should or can be given in the top-file. The top-file should or can contain not 
only assignment information but also preamble commands and macro-commands. An example of 

a top-file is given below. 

The command ’/oEDF means end of file: Spike ignores everything which follows after this line. This 
command is not compulsory. 

Top-hle consists of two parts: the MATLAB part and the lATj^X-part. The line which starts with 
\documentclass separates the MATLAB and the lAlEX-parts of the top-file. Spike executes commands 
in the MATLAB part and copies the LT^^^X-part into the beginning of the output lAfJ^-file. 

Some of the BTgX-part commands may contain references to the topic code and the assignment 
number, which are given as arguments to Spike. In Spike there are two lAfJ^^X- commands \topiccode 
and \NAss which define the topic code and the assignment number respectively. Spike automatically 
defines these commands when it encounters the line \begin{document} in the top-file. 

That is, in the top-file one can use commands \topiccode and \NAss after \begin{document} 

without defining them. 

3.13. Spike variables. Spike has several variables: duedate, rseed, NAltAns, NRepeat. rseed is a 
seed for MATLAB’s generator of pseudo-random numbers, NAltAns is the number of alternative answers, 
NRepeat is the number of times each assignment question is repeated. 

By default, NAltAns=5, and NRepeat=l. These default values can be changed in the MATLAB part 
of the top-file. They can also be changed in a data-block of spk-file. 

For example, to change the number of alternative answers from five to four one can to insert the 
command 

NAltAns = 4; 

to the top-file. Another option is to insert the following data block in the beginning of spike-file: 
<<data; 

NAltAns = 4; 

» 

3.14. Assignment cycle. The code which is given in a spike-file is executed in a cycle. We shall call 
it assignment cycle. To produce k assignments Spike runs the code of spike-file k times. How many 
times to run the spike-code is determined by the student-list file: if there are, say, 27 student ID’s before 
the hrst seven dashes line, then the spike-code will be run 27 times. As a result 27 assignments will be 
prepared. They are all given in a single LaTeX file, so a student can see other students assignments too. 

It should be mentioned that Matlab-code which is given in the top-file is executed only once and before 
preparing the first assignment. On the other hand, any Matlab code which is given in data-block of a 
spike-file is executed in every run of the assignment cycle. Thus, if for example the number of alternative 
answers is set to four by the command NAltAns = 4; in the top-file, but somewhere in spike-file it is 
changed to another value, say NAltAns = 3;, then this value will stay until it is changed by another 
command. The same remark applies to all other spike variables, such as NRepeat etc. 

3.15. Curved brackets operator. It was already mentioned that Spike has a special feature which 
allows to randomize variables. Since the aim of Spike is to create randomized questions, randomization 
operators in Spike are obviously used very often. While one can use Matlab’s operators rand and randi. 
Spike’s randomization operators provide a little bit more flexibility. 

For example, assume that we wish a variable a to take values from 5 to 12 with equal probabilities. 
This can be achieved by the following command: 
a = {5:12}; 

If we want b to take values from the interval 2..5 or from the interval 10..15 so that every number has 
equal chance to be chosen, then we can use the operator 
a = {2:5,10:15}; 

One can have any number of intervals here. Moreover, the intervals may overlap: 
a = {1:5,7:9, 10:14, 12:16}; 
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But if the intervals overlap, the overlapped numbers have a better chance to be chosen. In general, 
probability to be chosen in a curved bracket operator is proportional to the number of appearances of 
the number in the list between curved brackets. This can be used to randomize certain variables in 
non-uniform way. For instance, assume that we wish a variable c to be equal to 3 with two chances out 
of five and to be equal to 7 with three chances out of five. This can be achieved by this operator: 
c = {3,3,7,7,7}; 

One can use more than one pair of curved brackets in one command. For example, 

X = -[1:53- + -[3:63-; 

This means that x will be given a value of a random variable which is the sum of two variables, first 
taking values from 1..5 and the second taking values from 3..6, with equal probabilities. The operator 
X = [{-3:5}, {3:6}, {-9:-2}]; 

would return a random vector. The curved brackets can be nested. For example, one can use the operator 
t = {1{2:5}:3{3:5}}; 

In such a case Spike first processes inner pairs of curved brackets. 

To avoid problems it is good to know how Spike processes commands with curved brackets. Spike 
first looks for curved brackets; it finds the first innermost pair {some stuff} of curved brackets within 
a line and then it replaces it with a randomly chosen element of the Matlab array [stuff] so that every 
element of the array has an equal chance to be chosen. So, if some element is repeated three times then it 
has three times more chance to be chosen. Once the first innermost pair of curved brackets is processed. 
Spike proceeds to the second innermost pair and so on. Once all curved brackets are replaced, the line is 
given to Matlab’s processor. 

For example, the command t = {1{2:5}: 3{3:5}}; may go through the following stages: 
t = {1{2:5}:3{3:5}}; —> t = {13:3{3:5}}; —> t = {13:35}; —> t = 22; 

So, Matlab’s processor will receive the command t = 22; 

For example, the following Spike code 
a = {1:8}; 
b = {1:8}; 

while a==b, b={l:8}; end 

should not be used. The aim of this code is to produce two different random integers a and b. But if it 
turns out that after the execution of the first two commands values of a and b are the same, say, 5, and 
the command b={l:8}; will again assign the value 5 (just by chance) to b then we will get an infinite 
loop. This is because in all cycles the command b={l :8}; will in fact be b=5; To avoid the infinite loop, 
one should not use curved brackets: 
a = {1:8}; 
b = {1:8}; 

while a==b, b=l+randi(7); end 

In creating randomized questions it is often necessary to obtain two or more different random numbers. 
In this regard, there are good news. For example, if we wish to get two different random integers a and 
b with values from the interval I..8 then we can use the command 
a,b!={l:8}; 

Here before the assignment operator ! = we can give a list of variables separated by commas. For each 
variable x in the list the assignment operator x={l: 8} will be executed in such a way that all variables 
in the list will get different random values. It is often desirable to have different values of variables which 
are sorted. In this case one should use !< instead of !=. For instance, the command 
a,b,c,d!={l:20}; 

will assign different values to variables a,b,c,d in such a way that a<b<c<d. 

The operators ! = and ! < we shall call multiple assignment operators. 

The only restriction in the usage of multiple assignment operators is that there should be only one 
pair of curved brackets and nothing else. For example, the operators 
a,b,c,d!={l:7, 2:10, 13, 14}; 
x,y,z!<{-0.1:0.7, 2:2:10}; 
are ok, but the operators 
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a,b,c,d!={l:7, 2:10, 1{3:4}}; 
x,y,z!<{-l:7}/10; 

are not. 

Finally, the array inside curved brackets does not need to be a number array. For instance, 

a,b!={’A’ ..’Z’}; 

x,y,z!<{’a’..’k’, ’hello’}; 

would work. In the second case here the three characters will be sorted in alphabetical order. 

4. At-line and its parameters 

Spike-blocks, except data-blocks and text-blocks, have what we shall call at-line or @-line. At-line 
separates the command-part of a spike-block from the text-part. But apart of this, at-lines have arguments 
which are separated by semi-colons. The first two arguments are compulsory, the third one is optional. 

4.1. First argument of at-line: marks. In the first argument we can give from one to four numbers 
such as in 
@3,2; a,b,c; 

This at-line has two arguments and the first argument has two numbers. The first number is treated 
as the number of points which a student gets for a correct answer to the question; the second number, 
if there is one, is treated as the number of negative “punishment” points which a student gets for an 
incorrect answer to the question; the third number, if there is one, is treated as the number of negative 
“punishment” points which a student gets for not answering the question. Finally, there can also be an 
optional fourth number in the first argument interpretation of which is up to a particular user. 

Depending on the number of numbers in the first argument of at-line. Spike prints different DTgX- 
commands into the output file. If there is one number N1 in the first argument of at-line, then the 
LaTeX command printed into the output file will be \problA. If there are two (respectively, three, four) 
numbers N1,N2 (respectively, N1,N2,N3 or N1,N2,N3,N4) in the first argument of at-line, then the LaTeX 
command printed into the output file will be \problB (respectively, \problC, \problD). 

For example, if we are testing knowledge of times-table, then we can use the following spike-block: 
<<problemI; 
a = {2:9}; 
b = {2:9}; 
answer ( ’ $7,4$ ’ , a*b) ; 

@2; a,b; 

Find the product of numbers y.d and y.d. 

» 

with the following result: 

\problemtype{I} 

\problA{B}{2} 

Find the product of numbers 5 and 9. 

\medskip\noindent 

(A) \ $32$ \quad 

(B) \ $45$ \quad 

(C) \ $28$ \quad 

(D) \ $12$ \quad 

(E) \ $72$ \quad 

20. [2m] Find the product of numbers 5 and 9. 

(A) 32 (B) 45 (C) 28 (D) 12 (E) 72 

The part [2m] of this text appears here because the command \problA was defined (in the top-file) to 
show the number of points which a student gets for the correct answer. If we wish to penalize a student 
for an incorrect answer, then we presumably need to show in the question itself what the penalty is. The 
penalty for an incorrect answer should be given as the second number of the first at-line argument, for 
example. 
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<<problemI; 
a = {2:9}; 
b = {2:9}; 
answer ( ’ $7od$ ’ , a*b) ; 

@2,2; a,b; 

Find the product of numbers 7od and 7od. 

» 

Since there are two numbers in the first argument, Spike will use \problB LaTeX command. 

\problemtype{I} 

\problB{D}{2}{2} 

Find the product of numbers 2 and 3. 

\medskip\noindent 

(A) \ $12$ \quad 

(B) \ $35$ \quad 

(C) \ $36$ \quad 

(D) \ $6$ \quad 

(E) \ $27$ \quad 

21. [2m,—2m] Find the product of numbers 2 and 3. 

(A) 12 (B) 35 (C) 36 (D) 6 (E) 27 

The part [2m,—2m] of this text appears here because the command \problB was defined (in the 
top-file) to show the number of points which a student gets for the correct answer and for an incorrect 
answer. 

Finally, if you are a teacher cruel enough to penalize students for no answer too, then you can use 
three numbers such as here: 

<<problemI; 
a = {2:9}; 
b = {2:9}; 
answer ( ’ $7od$ ’ , a*b) ; 

@2,2,1; a,b; 

Find the product of numbers 7od and 7od. 

» 

in order to get this: 

\problemtype{I} 

\problC{E}{2}{2}{l} 

Find the product of numbers 6 and 5. 

\medskip\noindent 

(A) \ $49$ \quad 

(B) \ $54$ \quad 

(C) \ $32$ \quad 

(D) \ $15$ \quad 

(E) \ $30$ \quad 

How to dehne the LaTeX command \problC in the top-file is up to you; I do not have a definition for 
this command since I am a kind teacher. 

Finally, there can be a fourth number in the first argument with resulting LaTeX command \problD, 
but interpretation and usage of this fourth number is open. 

4.2. Second argument of at-line: the text part arguments. The second argument of at-line shows 
the list of variables which are used in the text-part of spike-block. 

Spike is about randomizing mathematical problems. When one chooses a problem to be randomized 
by Spike, one has to decide which and how many elements of the problem is to randomize. Once the 
elements to be randomized are chosen, in the second argument of the at-line we give a list of variables 
values of which are supposed to replace to be randomized elements, and these elements themselves in 
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the text of the problem we replace by the Matlab formatting operators such as 7,d, 7o.3f, 7,c, 7oS etc, 
exactly as they are used in Matlab’s fprintf command. 

For example, let us consider the following problem: 

Find the scalar product of vectors a = (3, —2, 5) and b = (6,4, —4). 

Here we can randomize two vectors {(}3,—2,5) and {(}6,4, —4) (or, if you like, six numbers). The 
following Spike code will do this: 

<<problemI; 

a=randi(20,1,3)-10; 
b=randi(20,1,3)-10; 
answ=a*b’; 

answer ( ’ $7od$ ’ , answ) ; 

@1,4; a(l),a(2),a(3), b(l),b(2),b(3) ; 

Find the scalar product of vectors $\mathbf a = (7od,7od,7od)$ and 
$\mathbf b = (7.d,7.d,7.d) . $ 

» 

\problemtype{I} 

\problB{C}{l}{4} 

Find the scalar product of vectors $\mathbf a = (8,4,-7)$ and 
$\mathbf b = (2,-6,9).$ 

\medskip\noindent 

(A) \ $4$ \quad 

(B) \ $0$ \quad 

(C) \ $-71$ \quad 

(D) \ $8$ \quad 

(E) \ $16$ \quad 

22. [Im,—4m] Find the scalar product of vectors a = (8,4, —7) and b = (2, —6, 9). 

(A) 4 (B) 0 (C) -71 (D) 8 (E) 16 

(Since this question is something really very basic the penalty score is big). This looks ok, but if we 
have, say, two 7-dimensional vectors then this solution would be a bit clumsy. In this case one may wish 
to write a Matlab function which tranforms a vector or a matrix into LaTeX format. Assume that we 
have written such a function and named it sLaTeXMatrix. Then the following Spike code can be used: 
<<probleml; 

a=randi(20,1,7)-10; 
b=randi(20,1,7)-10; 
sa=sLaTeXMatrix(a); 
sb=sLaTeXMatrix(b); 
answ=a*b’; 

answer ( ’ $7od$ ’ , answ) ; 

@1,4; sa, sb; 

Find the scalar product of vectors 

$$\mathbf a = 7oS$$ 

and 

$$\mathbf b = 7oS . $$ 

» 

Note that the formatting operator used here is 7oS since sa and sb are string variables. 
\problemtype{l} 

\problB{A}{l}{4} 

Find the scalar product of vectors 

$$\mathbf a = \left(\begin{matrix}5&9&0&-7&l&-3&-2\\\end{matrix}\right)$$ 
and 

$$\mathbf b = \left(\begin{matrix}-l&-l&-8&-9&3&-5&5\\\end{matrix}\right).$$ 
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\medskip\noindent 

(A) \ $57$ \quad 

(B) \ $34$ \quad 

(C) \ $-33$ \quad 

(D) \ $9$ \quad 

(E) \ $-15$ \quad 

23. [1 m,—4m] Find the scalar product of vectors 

a=(5 9 0 -7 1 -3 -2) 

and 

b=(-l -1 -8 -9 3 -5 5). 

(A) 57 (B) 34 (C) -33 (D) 9 (E) -15 

Finally, one may wish to randomize not only numbers in the above problem but also notation for 
vectors a and b. That is, we may wish to use different letters to denote these two vectors. The following 
code achieves this aim. 

<<problemI; 

x,y!<{’abcdefgxyz’}; 
a=randi(20,1,3)-10; 
b=randi(20,1,3)-10; 
answ=a*b’; 

answer ( ’ $7od$ ’ , answ) ; 

@1,4; X, a(l),a(2),a(3), y, b(l),b(2),b(3) ; 

Find the scalar product of vectors $\mathbf 7oC = (°/od,yod,°/od)$ and 
$\mathbf "/.c = (7d,7d,7d).$ 

» 

\problemtype{I} 

\problB{B}{l}{4} 

Find the scalar product of vectors $\mathbf d = (6,3,-4)$ and 
$\mathbf g = (-9,5,10).$ 

\medskip\noindent 

(A) \ $-84$ \quad 

(B) \ $-79$ \quad 

(C) \ $14$ \quad 

(D) \ $-35$ \quad 

(E) \ $-19$ \quad 

24. [Im,—4m] Find the scalar product of vectors d = (6,3, —4) and g = (—9, 5,10). 

(A) -84 (B) -79 (C) 14 (D) -35 (E) -19 

Finally, one may randomize even the wording of the problem. 

\problemtype{l} 

\problB{D}{l}{4} 

Find $\mathbf d \bullet \mathbf f$ if $\mathbf d = (-9,0,2)$ and 
$\mathbf f = (9,6,9).$ 

\medskip\noindent 

(A) \ $-27$ \quad 

(B) \ $-62$ \quad 

(C) \ $-3$ \quad 

(D) \ $-63$ \quad 

(E) \ $-59$ \quad 
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25. [Im,—4m] Find d • f if d = (—9, 0, 2) and f = (9,6, 9). 

(A) -27 (B) -62 (C) -3 (D) -63 (E) -59 

This was achieved by the following code: 

<<problemI; 

X,y!<{’abcdefgxyz’}; 

ss=’the scalar product of vectors’; 

bb=(rand<0.5); 

if bb, ss=sprintf (’ $\\mathbf 7oC Wbullet Wmathbf °/oC$ if ’,x,y); end 
a=randi(20,1,3)-10; 
b=randi(20,1,3)-10; 
answ=a*b’; 

answer ( ’ $7,d$ ’ , answ) ; 

@1,4; ss, X, a(l),a(2),a(3), y, b(l),b(2),b(3); 

Find 7oS $\mathbf 7,c = (7,d,7,d,7od)$ and 
$\mathbf 7c = (7.d,7.d,7.d) . $ 

» 

In this case in 50 percent of cases the phrase .. the scalar product of vectors ...” will be used and 
in another 50 percent of cases Spike will use an expression of the kind “... a • b if ...”. 

4.3. Third argument of at-line: NAItAns. Spike allows to change the number of multiple choice 
answers from default value of five to any number between 2 and 8. This can be done in a data-block 
directly by changing value of the spike variable NAItAns. For example, the spike code 
<<data; 

NAltAns=2; 
p=5; 

» 

<<problemI; 

[f,g]=GetIrreducibleDegree2Poly(p); 
x=rand; 

if x<0.5, ss=PolyToLaTeX(f); answ=’Yes’; end 
if x>=0.5, ss=PolyToLaTeX(g); answ=’No’; end 
answer ( ’ 7«s ’ , answ) ; 

@3,2; ss,p; 

Is the polynomial $f (x) = 7oS$ from $\mbZ_{7od} [x] $ irreducible? 

» 

gives this output: 

\problemtype{I} 

\problB{A}{3}{2} 

Is the polynomial $f(x) = 2+x+x~{2}$ from $\mbZ_{5}[x]$ irreducible? 

\medskip\noindent 

(A) \ Yes \quad 

(B) \ No \quad 

26. [3m,—2m] Is the polynomial f{x) = 2 + x + from Zs]^] irreducible? 

(A) Yes (B) No 

The problem is that once value of NAItAns is changed, it will affect all subsequent questions. Of course, 
the old value can be saved and then restored back after a problem but this is a bit clumsy. 

If one wishes to change the number of alternative answers only in one question then this number can 
be given as the third argument of the at-line: 

<<problemI; 

[f,g]=GetIrreducibleDegree2Poly(p); 
x=rand; 
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if x<0.5, ss=PolyToLaTeX(f); answ=’Yes’; end 
if x>=0.5, ss=PolyToLaTeX(g); answ=’No’; end 
answer(’Zs’,answ); 

@3,2; ss,p; 2; 

Is the polynomial $f (x) = 7oS$ from $\mbZ_{°/od} [x] $ irreducible? 

» 

\problemtype{I} 

\problB{A}{3}{2} 

Is the polynomial $f(x) = l+3x+2x~{2}$ from $\mbZ_{5} [x]$ irreducible? 


\medskip\noindent 

(A) \ No \quad 

(B) \ Yes \quad 


27. [3m,—2m] Is the polynomial f{x) = l + 3x + 2x^ from "L^lx] irreducible? 

(A) No (B) Yes 

This way of changing the number of alternative answers will not affect other questions. 


5. Marking 


When Spike processes a spike-file it not only produces the output assignment lAI^-file, but it also 
keeps information about assignment questions: what type of question-block (I,R,T,G, H or V) it was 
created by, question number, the positive mark for the correct answer given to the question, the negative 
mark given for an incorrect answer and the correct answer to the question. 

This information is written in the output RTJ^^X-file after the \end{document} command. ignores 

everything which follows after \end{document}, and so this is safe to do so. Of course, this information 
could be kept in a separate file, but firstly it is desirable to decrease the number of files, and secondly it 
is helpful to keep correct answers to an assignment in the same file as the assignment itself in order to 
avoid a possible confusion. 

I give a real-life example. In my PDE topic with topic code MATH3712 there are sixteen students with 
student numbers (these numbers were modified) 


2019463 2083123 
2028028 2092052 
2060521 2092462 
2062027 2093747 


2095869 2108070 
2099265 2112299 
2104714 2123762 
2107353 2126266 


These numbers are kept in the file MATH3712.tex in MATH3712\ folder. Hence, Spike creates 16 
assignments, one for each student. 

At the end of the output assignment HTJ^X-Hle for the third assignment after the command \end{document} 
the following text is inserted: 

Topic code: MATH3712 

Assignment number: 3 

Number of questions: 22 


PrbType: RRRRRRTRTTRRRRTRRRRRRR 
•/.MARKING 

Numbers:1234567890123456789012 

Specfcs:. 

Weights:3322233211222122222312 
Neg wts:0000001000000100010000 
2108070:ADCDEDCEDCADDACEDACEEA 
2060521:EDBBBADEDCDECDACDADEAC 
2092052:ECEEEECADDAEBBCBAAEABC 
2092462:BDABEEDAAAACBEDADBADCD 
2123762:DCBDDDAAACABCABCDABAEA 
2083123:BACECACBAAAAADABDBBBDE 
2107353:EDAEDBBACAEBBBCBAEBABD 
2019463:DCABCECABABBBADCCECAED 
2104714:AEDAEBBBABDDCBACDCEAEA 
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2099265:ECCDBACACBBDDACACBDADD 
2126266:DEDEBBCAACDBDAABEBCDBA 
2062027:EBCAEABAACBACBCDAEBEBB 
2093747:BDBECDCACDADDDABABADDC 
2028028:ADEDCBBACCDAEDDEBAEECC 
2112299:BDDEAEABDBBDBCCBDCDCCA 
2095869:ECCCDADCAACBBEDADEDBAD 


"/Insert here students’ answers. 

Once students answers are received, I insert them after the seven dash line-as follows: 

Topic code: MATH3712 

Assignment number: 3 

Number of questions: 22 

PrbType: RRRRRRTRTTRRRRTRRRRRRR 
•/MARKING 

Numbers:1234567890123456789012 

Species:. 

Weights:3322233211222122222312 
Neg wts:0000001000000100010000 
2062027:EBCAEABAACBACBCDAEBEBB 
2028028:ADEDCBBACCDAEDDEBAEECC 
2092052:ECEEEECADDAEBBCBAAEABC 
2108070:ADCDEDCEDCADDACEDACEEA 
2083123:BACECACBAAAAADABDBBBDE 
2099265:ECCDBACACBBDDACACBDADD 
2126266:DEDEBBCAACDBDAABEBCDBA 
2112299:BDDEAEABDBBDBCCBDCDCCA 
2107353:EDAEDBBACAEBBBCBAEBABD 
2092462:BDABEEDAAAACBEDADBADCD 
2019463:DCABCECABABBBADCCECAED 
2060521:EDBBBADEDCDECDACDADEAC 
2104714: AEDAEBBBABDDCBACDCEAEA 
2093747:BDBECDCACDADDDABABADDC 
2123762:DCBDDDAAACABCABCDABAEA 
2095869:ECCCDADCAACBBEDADEDBAD 


2108070:ADCDEDCDDCADDABEDACEEA 
2095869:ECCCDADCAACBBEDADEDBAD 
2060521:EDBBBADEDCDECDACDAEEAC 
2028028:ADEDCBBABBDAEDDEBAEECC 
2083123:BACECACBAAAAADABDBBBDE 
2093747:BDBECDCACDADDDABABADDC 
2104714:AEDAEBBBABDDCBACDCEAEA 
2019463:DBABEECAAABDBADCCCCAED 
2099265:ECCDBACACBBDDACACBDADD 
2107353:EDAEDBBACAEBBBCBAEBABD 
2092462:BDABEEDADAACBEDADBADDD 
2062027:EBCAEABAACBACBCDAEBEBB 
2123762:CBADBE.ADBCCE.BCB.ACDB 


Students ID’s don’t need to be sorted. The above information is used by a marking program SpikeMark 
to mark the assignment. 
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The following text is the marking results file prepared by SpikeMark. 

Flinders University 2014 Semester 2 
MATH3712 Assignment 3 marks as by 04-Nov-2014 



Stud.ID 

Answers 

points 

mark 

12 

!|<!|<!|<!|<027 

+++++ +++++ +++++ +++++++ 

45 

20.0 

14 

****028 

+++++ +++CC +++++ +++++++ 

43 

19.1 

3 

****052 


0 

0.0 

1 

****070 

+++++ ++E++ ++++C +++++++ 

41 

18.2 

6 

****123 

+++++ +++++ +++++ +++++++ 

45 

20.0 

10 


+++++ +++++ +++++ +++++++ 

45 

20.0 

11 



0 

0.0 

15 

****299 


0 

0.0 

7 

****353 

+++++ +++++ +++++ +++++++ 

45 

20.0 

4 

****462 

+++++ +++A+ +++++ +++++C+ 

43 

19.1 

8 

****463 

+C++C +++B+ +B+++ ++E++++ 

34 

15.1 

2 

****521 

+++++ +++++ +++++ +++++++ 

45 

20.0 

9 

****714 

+++++ +++++ +++++ +++++++ 

45 

20.0 

13 

****747 

+++++ +++++ +++++ +++++++ 

45 

20.0 

5 

****762 

DCB+D D.+AC ABC.+ +D.BAEA 

8 

3.6 

16 

,k,k,k,k869 

+++++ +++++ +++++ +++++++ 

45 

20.0 


Ques.N. 

12345 67890 12345 6789012 

Total: 

Total: 


Weight 

33222 33211 22212 2222312 

45 

20 


Neg.wt 

00000 01000 00010 0010000 




If a student’s answer is incorrect, then a correct answer A,B,C, . . . or is shown in the table. 

means that the answer given by a student is incorrect and the correct answer will be given later. 
" + " means that the answer given by a student is correct. 

"." means that the answer was not given. 


Numbers of correct answers given to each question: 


1 

2 

3 

4 

5 

6 

7 

8 

9 

10 

11 

12 

13 

14 

15 

16 

17 

18 

19 

20 

21 

22 

12 

11 

12 

13 

11 

12 

12 

12 

9 

11 

12 

11 

12 

12 

12 

13 

12 

11 

11 

12 

11 

12 

92 

85 

92 

100 

85 

92 

92 

92 

69 

85 

92 

85 

92 

92 

92 

100 

92 

85 

85 

92 

85 

92 


Number of students enrolled in this topic: 16. 
Number of submissions: 13. 

The average mark for this assignment: 14.6. 
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6. Appendix A: Examples of assignments 
The best way to learn to use Spike is to follow an example. 


6.1. A statistics assignment. Since statistics is a very popular subject I decided to create an example of a 
“statistics assignment”. On second thought, medical applications of statistics are even more popular, and so many 
questions in this assignment have medical flavour. I did not test this assignment with real students and so I do 
not guarantee that this code is free of mistakes. 


"/o Definition of probability 


<<problemI; 

N={2:12}; 

if (N==2)I I(N==12), p=l/36; end 
if (N==3)I I(N==ll), p=l/18; end 
if (N==4)I I(N==10), p=l/12; end 
if (N==5)I I(N==9), p=l/9; end 
if (N==6)I I(N==8), p=5/36; end 
if N==7, p=l/6; end 
answer ( ’ $y,s$ ’ , sLaTeXFrac(p) ) ; 

@2,1; N; 

Assume that a pair of fair dice are thrown. 

What is the probability that the sum of numbers 
on their faces is equal to "/.d? 

>> 


<<text; 

\bigskip 

\noindent {\bf Definition of probability.}- 
>> 

<<problemR; 

N={7:20}; 

R={8:22}; 
a=zeros(N,N); 

for j=l:N, for k=l:N, if j~2-Hk~2 < R, a(j,k)=l; end; end; end; 
ans=sum(sum(a))/N“2; 
answer ( . 3f ’ ,ans) ; 

@2,1; N,N,R; 

Assume that we choose randomly and independently two numbers~$X$ and~$Y$ 
between 1 and "/.d, so that each of those "/.d numbers have an equal 
chance to be chosen euid maybe be equal. What is the probability 
that $X~2 -hY~ 2$ is less than $y,d?$ 

Round the answer to three digits. 

>> 


y Expectation E(X) 


<<text; 

\bigskip 

\noindent {\bf Expectation $E(X)$ of a random variable.} 
>> 


<<problemI; 

p=GetRandProbDist(4,1); 
X=randi(10,l,4); 

X=sort(X); 

X=X-H[0,1,2,3] ; 
ans=sum(p.*X); 
answer ( ’"/O. If ’ , cins) ; 
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@2,0; X(l),X(2),X(3),X(4),p(l),p(2),p(3),p(4); 

A random variable $X$ takes values $"/od, "/,d, "/d, $ 

and $°/,d$ with probabilities . If . If . If , $ and $°/, .lf$ 

respectively. Find $E(X).$ 

» 


«problemI; 

x=randi(900)/lOO; 
y=randi(900)/lOO; 
a=randi(90)/10; 
b=randi(90)/10; 
answer ( ’ °/,. 4f ’ , a*x+b*y) ; 

@2,0; x,y,a,b; 

Random variables $X$ and $Y$ have expectations $’/,.2f$ and 
$’/..2f$ respectively. What is the expectation of the random 
variable $"/.. IfX+"/.. lfY?$ 

» 

«text; 

\bigskip 

\noindent {\bf Variance $\Var(X)$ of a random variable.}- 

» 


y. Variance Var(X) 


«problemI; 

p=GetRandProbDist(3,1); 

X=randi(10,l,3); 

X=sort (X) ; 

X=XH-[0,1,2] ; 

X2=X.*X; 

ans=sum(p.*X2)-sum(p.*X)*2; 
answer(’y,0.2f’ ,ans) ; 

@2,0; X(l),X(2),X(3),p(l),p(2),p(3); 

A random variable $X$ takes values $yod,y,d,$ 

and $y,d$ with probabilities . If ,7,. If ,$ and $7, .lf$ 

respectively. Find variance of $X.$ 

» 


«problemI; 

x=randi(900)/lOO; 
c=randi(90)/10; 
answer ( ’7,. 4f ’ , c“2*x) ; 

@2,0; x,c; 

A random variable $X$ has variance $yo.2f.$ 

What is the variance of the random variable $7. .lfX?$ 

» 


«text; 

\bigskip 

\noindent {\bf Bernoulli trials.} 

» 


yx/x/x/x/x/x/x/x/x/x/x/x/x/xm^^^^ 

7, Bernoulli trials 

y.r///.y;/;///.y.r///.y.r///.y.r/;/.y.r/;/.y.r///.y.y.r///.7.y.%^ 

«problemI; 
n={7:ll}-; 
k={2:5}; 

p=nchoosek(n,k)/2~n; 

answer ( ’ $7.s$ ’ , sLaTeXFrac (p) ) ; 



34 


NURULLA AZAMOV 


@3,0; n,k; 

Assume that a fair coin is thrown "/d times, so that the chance to get 
a head or a tail in each throwing is 0.5. What is the probability that 
one gets ’/.d heads? 

» 


«problemR; 

n={7:ll}; 

k={2:5>; 

prvl={9:28>/100; 

p=nchoosek(n,k)*prvl~k*(1-prvl)“(n-k); 
answer ( . 5f ’ ,p) ; 

@3,0; prvl,k,n; 

Prevalence of a medical condition in a population is equal to "/o.2f. 

What is the probability that exactly ’/,d people from a ramdom sample 
of "/od people chosen from this population have the condition? 

» 

«problemR; 

n={7:ll}; 

k={2:5>; 

prvl={21:50}/100; 

p=nchoosek(n,k)*prvl~k*(1-prvl)“(n-k); 
answer ( . 5f ’ ,p) ; 

@3,0; prvl,k,n; 

The probability that a patient with a disease A dies during the next 
year is "/o.2f. What is the probability that exactly "/,d patients with this 
disease from a ranidom sample of "/,d patients will die during the next year? 
» 


«text; 

\bigskip 

\noindent {\bf Properties of $\Pr(A).$}- 

» 


"/o Properties of Pr(A) 


«problemT; 

y False 

$\Pr(A+B) = \Pr(A) + \Pr(B).$ 

If the events $A$ and $B$ are independent then $\Pr(A+B) = \Pr(A)+\Pr(B).$ 
$\Pr(AB) = \Pr(A)\Pr(B).$ 

$\Pr(A\mid B) = \Pr(B\mid A).$ 

If the events $A$ and $B$ are independent then $\Pr(A\mid B) = \Pr(A)\Pr(B).$ 
The event $A$ is independent form itself. 


y True 

$0 \leq \Pr(A) \leq l.$ 

$\Pr(A+B) = \Pr(A) + \Pr(B) - \Pr(AB).$ 

If the events $A$ and $B$ are independent then $\Pr(AB) = \Pr(A)\Pr(B).$ 
If the events $A$ and $B$ are independent then $\Pr(A\mid B) = \Pr(A).$ 
$\Pr(AB) = \Pr(A\mid B)\Pr(B).$ 

$\Pr(A\mid B) = \Pr(B\mid A)\Pr(A)/\Pr(B).$ 

$\Pr(B) = \Pr(B\mid A) \Pr(A) + \Pr(B\mid \bar A) \Pr(\bar A).$ 

y 

@1,0;6; 

y 

Let $A$ and $B$ be two random events. Recall that $A+B$ also 
denoted as $A \cup B$ is the event that at least $A$ or $B$ 
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will happen and that $AB$ also denoted as $A \cap B$ is the event 
that both $A$ and $B$ will happen. Let also $\bar A$ 
be the complement of $A.$ How many of the following 
assertions are always correct? 

» 

«text; 

\bigskip 

\noindent {\bf Properties of $E(X)$ and $\Var(X)$} 

» 


y. Properties of E(X) and Var(X) 

y.y;/.y;/.y;/.y;/.y;/.y;/.y;/.y;/.y;/.y;/.y;/.y;/.y;/.y;/.y.y;/.y;/;/.y;/;/;/;/.y;/.y 


«problemT; 
y. False 

$x_l+\ldots+x_n=l.$ 

$E(XY) = E(X)E(Y).$ 

$E(X*2) = [E(X)]~2.$ 

$E(\abs{X}-) = \abs{E(X)}.$ 

$E(g(X)) = g(E(X)).$ 

For any real number $c$ \ $\Var(cX) = c\Var(X).$ 
If $c$ is a constant then $E(c) = 0.$ 

If $c$ is a constant then $\Var(c) = c.$ 

$E(X) \geq 0.$ 


y. True 

$p_l+\ldots+p_n=l.$ 

$E(X+Y) = E(X)+E(Y).$ 

For any number $c$ \ $E(cX) = cE(X).$ 

If $c$ is a constant then $E(c) = c.$ 

$E(X) = p_lx_l+\ldots+p_nx_n.$ 

$E(X*2) = p_lx_l~2+\ldots+p_nx_n~2.$ 

$E(g(X)) = p_lg(x_l)+\ldots+p_n g(x_n).$ 

$\Var(cX) = c*2\Var(X).$ 

If $X$ and $Y$ are independent then $E(XY) = E(X)E(Y).$ 

If $X$ and $Y$ are independent then $\Var(X+Y) = \Var(X) + \Var(Y).$ 

For any real number $c$ \ $\Var(cX) = c*2\Var(X).$ 

$\Var(X) = E(X“2)- [(E(X)]~2.$ 

$\Var(X) \geq 0.$ 

$E(X-2) \geq 0.$ 

If $c$ is a constant then $\Var(c) = 0.$ 

If $\Var(X) = 0$ then $X$ is a constemt random variable. 

^ - 

Let $X$ be a random variable which takes values $x_l,XldoTs,x_n$ and only 
these values with respective probabilities $p_l,\ldots,p_n,$ let $Y$ be 
another random variable and let $g(x)$ be a function. How many of the 
following assertions are always correct? 

» 

«text; 

\bigskip 

\noindent {\bf The Central Limit Theorem} 

» 

«problemI; 
n={101:300}; 

k=floor(7*n/15) + randi(round(n/15)); 

z=(2*k/n-l)/sqrt(n); 

answer ( ’y,. 4f ’ ,normcdf (z, 0,1) ) ; 

@2,0; n,k; 

A fair coin is thrown ’/.d times. 
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Find the probability that the number of tails will not exceed °/,d. 

» 


«problemR; 

n={101:300>; 

k=floor(7*n/15) + randi(round(n/15)); 

z=(2*k/n-l)/sqrt(n); 

answer ( .4f ’ ,normcdf (z,0,1) ) ; 

@2,0; n,k; 

A fair coin is thrown ’/,d times. 

Find the probability that the number of tails will not exceed °/,d. 

» 

«problemR; 

n={101:300>; 

p={15:34}/100; 

q=l-p; 

sigma=sqrt(p*q) ; 
sqrtn=sqrt(n); 

X = n*p + (rand-1/2)*sqrtn*sigma; 
k=round(x); 

z=(k/n-p)*sqrtn/sigma; 
answer ( .4f ’ ,normcdf (z, 0,1) ) ; 

@2,0; p,k,n; 

Prevalence of a medical condition in a population is equal to "/o.2f. 

What is the probability that no more than °/,d people from a random sample 
of "/od people chosen from this population have the condition? 

» 

«problemR; 
n={101:300>; 
p=GetRandProbDist(3,1); 

X=randi(10,l,3); 

X=sort(X); 

X=X+[0,1,2] ; 

EX=sum(p.*X); 

sigma=sqrt(sum(p.*X.*X)-EX~2); 

t = EX+(2*rand-l)*sigma/sqrt(n); 
t=round(t*100)/100; 
z=(t-EX)*sqrt(n)/sigma; 
answer ( ’"/0.4f ’ ,normcdf (z ,0,1) ) ; 

@2,0; X(l),X(2),X(3),p(l),p(2),p(3),n,n,n,t; 

A random variable $X$ takes values $"/od,"/,d$ 
and $°/,d$ with probabilities . If . If $ and $’/, .lf$ 
respectively. Let $X_1 ,\ldots,X_{’/.d}-$ be a sequence of mutually 
independent random variables which have the same distribution as~$X.$ 

Let $\bar X = (X_l+\ldots+X_{"/od}-)/{"/od}. $ Find the probability 
that $\bar X \leq "/..3f.$ 

» 

«text; 

\bigskip 

\noindent {\bf Bayes Formula}- 

» 

«problemI; 
sns={70:99}-; 
sns=sns/100; 
spc={70:99}-; 
spc=spc/100; 
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prvl= (2+r£aidi (20) ) /lOO; 

PB=sns*prvl + (l-spc)*(l-prvl); 
answer ( ’. 4f ’ , PB) ; 

@2,0; sns,spc,prvl; 

Recall that sensitivity of a disease test is the probability of 
a positive test result (a patient has the disease) if he/she indeed has it, 
and specificity of a test is the probability of a negative test result 
(a patient does not have the disease) if he/she indeed does not have it. 

A test for diagnosing a disease has sensitivity "/,.2f 

and specificity "/o.2f. Prevalence of the disease in a population is "/o.2f. 
Find the probability that for a randomly chosen person from the 
population the test would give a positive result. 

>> 

<<problemI; 
sns={70:99}-; 
sns=sns/100; 
spc={70:99}-; 
spc=spc/100; 
prvl=(2+r£mdi(20))/lOO; 

PB=sns*prvl + (l-spc)*(l-prvl); 
ans = sns*prvl/PB; 
answer(’"/o.4f’ ,ans) ; 

@2,1; sns,spc,prvl; 

Recall that sensitivity of a disease test is the probability of 
a positive test result (a patient has the disease) if he/she indeed has it, 
and specificity of a test is the probability of a negative test result 
(a patient does not have the disease) if he/she indeed does not have it. 

A test for diagnosing a disease has sensitivity "/,.2f 

and specificity "/o.2f. Prevalence of the disease in a population is "/o.2f. 

The disease test for a person from that population gave a positive result. 
Find the probability that the person actually has the disease. 

>> 

<<text; 

\bigskip 

\noindent {\bf Properties of covariance and correlation} 

>> 

<<problemT; 

"/o False statements 

If $\rho(X,Y) = 0$ then the random variables $X$ and $Y$ are independent. 

If $\Cov(X,Y) = 0$ then the random variables $X$ and $Y$ are independent. 

$-1 \leq \Cov(X,Y) \leq l.$ 

For any random variable $X$ \ \ $\rho(X,X) = 0.$ 

For any random variable $X$ \ \ $\Cov(X,X) = 0.$ 


"/o True statements 

$-1 \leq \rho(X,Y) \leq l.$ 

For Euiy random variable $X$ \ \ $\rho(X,X) = l.$ 

$\Cov(X,Y) = E[(X-EX)(Y-EY)].$ 

$\rho(X,Y) = \Cov(X,Y)/\sqrt{\Var(X)\Var(Y)}.$ 

$\abs{\Cov(X,Y)} \leq \sqrt-[\Var (X)\Var(Y)}. $ 

If $X$ and $Y$ are independent then $\rho(X,Y) = 0.$ 

If $X$ Euid $Y$ are independent then $\Cov(X,Y) = 0.$ 

$\Cov(X,X) = \Var(X).$ 

If $X$ cuid $Y$ have normal distributions and $\rho(X,Y) = 0,$ then $X$ and $Y$ are independent. 
For any numbers $a$ and $b$ \ \ $\Cov(aX_l+bX_2,Y) = a\Cov(X_l,Y) + b\Cov(X_2,Y).$ 

$\Cov(X,Y) = \Cov(Y,X).$ 

@2,1;8; 

How many of the following assertions are correct? 

>> 
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«text; 

\bigskip 

\noindent {\bf Confidence intervals.} 

» 


"/o Confidence intervals 


«problemI; 
percent= 
n={201:500}; 
k={101:190}; 
phat=k/n; 

sigmahat=sqrt(phat*(1-phat)/n); 
lo=phat-norminv(0.975,0,l)*sigmahat; 
up=phat+norminv(0.975,0,1) *sigmEdiat; 
answer ( ’ $ ("/. 3f . 3f )$ ’ , lo,up) ; 

@3,0; k,n,percent; 

A biostatistician would like to estimate prevalence $p$ of a medical 
condition in a population. In a trial exactly "/d people from a random 
sample of "/d people chosen from this population were found to have 
the condition. Find 95\y,c confidence interval for the prevalence~$p. $ 
» 


y Poisson distribution 

uuuuuuuuuuuuuum:/:/:m^^^^ 


«problemZ; 

n = {1501:5000}; 
lmb=n/365; 

k=round(lmb) + 4 - r£uidi(7); 
p=exp(-lmd)*lmb“k/factorial(k); 
answer(’$.4f$’,p); 

@2,0; n,k; 

An emergency department of a hospital gets on average "/d patients 
in a year (365 days). What is the probability that in one day the 
emergency department will get ’/.d patients? 

» 
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7. Appendix B: SpikS code 


"/o Spike, version L3. 

"/o Author: Nurulla Azamov, Flinders University 2014. 
•/. Last modified: 13/11/2014. 

•/. 

"/o Usage: spike(TopicCode,AssNumber) . 

•/. 

•/.Example: spike (’MATH3701 ’ ,2) . 

•/. 

•/. Input: 

•/. TopicCode, an 8-symbol topic code. 

•/. AssNumber, assignment number. 

•/. 


•/. 

•/. 

•/. 

•/. 

•/. 

•/. 

•/. 

•/. 

•/. 

•/. 

•/. 

•/. 

•/. 

•/. 

•/. 

•/. 

•/. 

•/. 

•/. 

•/. 

•/. 


To run spike, there must be four files: 

(a) Topfile, 

this is a file the content of which spike copies 
into the beginning of the output. 

Topfile may also contain some Matlab commands to be executed 
before the spike-code. 

(b) TopicCodeAn.spk, 

this is a file with spike-code. 

(c) TopicCode.txt, 

this is a file with a list of student ID’s 
enrolled in the topic. The file TopicCode.tex is 
kept in the topic folder TopicCode. 

This file may look as follows: 

2071253 

2022880 

2095220 

2119922 

2107080 


•/. Output: 

•/. a LaTeX file with an assignment. 

•/. This output-LaTeX file is saved in the topic folder. 
•/. The saved output file is opened in Matlab’s editor. 


function spike(TopicCode,AssNumber) 

fprintf(’spike, version L3. Nurulla Azamov, Flinders University 2014.\n’); 


•/. Initialization of certain parameters. 

uuuuuuuuuuuuuumx/xm^^^^ 


MAX_NUMBER_DF_QUESTI0NS=80; 


•/. Proportion of total assessment, which this assignment constitutes. 

•/. By default, it is 10"/, 

evalinC’base’,’PercentMarks=10;’); 


"/. Assignment due date. 

"/. By default, it is ’to be announced’. 
evalinC’base’,’duedate=’’TBA’’;’); 

"/. How many times to repeat each test question. 
"/. By default, only once. 
evalinC’base’,’NRepeat=l;’); 
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"/o Number of alternative multiple choice answers. 

"/o By default, it is 5. 
evalinC’base’,’NAltAns=5;’); 

"/o Random seed. 

evalinC’base’,’rseed=247;’); 

"/o currdir=cd; 

"/o cd( ’ \\userab\a\azam0001\DriveH\Documents\MATLAB\Spike ’ ) ; 


"/o Initialization of topic data. 


Topic=topic(TopicCode) ; 


"/o Creating the Out-file and opening it for writing. 


OutFile=sprintf (’"/.sWy.s ’ .Topic . code,Topic. code) ; 
if isnumeric(AssNumber), 

OutFile=sprintf (’’/.sA’/.d. tex’ .OutFile,AssNumber) ; 

else 


OutFile=sprintf ( ’’/.sExamPaper. tex’ , OutFile) ; 

end 


0utF=f openCOutFile, ’ w’) ; ’/. the LaTeX out file 
if 0utF~=-l, 

fprintfC’The file ’/.s already exists.\nlt is overwritten. \n’.OutFile) ; 

end 

fprintf(’Please wait ...\n’); 

fprintf (OutF,’y,y. This file was created on ’/.s by spike, version L3. \n’.date) ; 


y. Processing the Matlab part of the top-file 

uuuuuuuuvamx/:/x/:/x/:/m^^^^ 

af=fopenC’topfile.tex’ ) ; 


y, Process MATLAB commands given in the top-file, 
y, until the line \documentclass. 

y. These commands may for instance change some constants, 
while ~feof(af), 
ss=fgetl(af); 

if length(ss)>=14 && strcmp(ss(l:14),’\documentclass’), 
fprintf (OutF, ’’/.sXn’ ,ss) ; 
break 

else 

if ("isempty (ss)) && (ss(l) “=’"/,’), 
try 

evalinC’base’,ss); 
catch ME 

fprintf(’\n\nSpike: ERROR in top-file.’); 

fprintf (’\ny.s\n\n’ ,ss) ; 

fprintf C’y.sXn’ ,ME. identifier) ; 

fprintf (’’/.sXn’ ,ME.message) ; 

return 

end 

end 

end 

end 

if evalinC’base’,’NAltAns > 8’), 

error(’The value of NAltAns should not exceed 8.’); 
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end 


y. Initialization of assignment data. 

uuuuuuuuuuuuuuv/:/x/x/xm 


Asst=assignment(TopicjAssNumber); 


y, Processing the LaTeX part of the top-file. 

y.y;/;/.y.y;/;/.y.y;/;/.y.y;/;/.y.y;/;/.y.y;/;/.y.y;/;/.y.y.y;/;/.y.y.y;/;/.y.y.y;/;/;/.y;/;/;/;/.y.y;/;/;/;/.y.y;/;/.y.y.y;/;/.y.y.y;/;/;/.y^ 


while ~feof(af), 
ss=fgetl(af); 

if length(ss)>=4 kk strcmpCss (1:4) ,’’/.EOF’) , 
break 

elseif length(ss) >=16 kk strcmpCss (1:16) ,’\begin-[document]-’) , 
fprintf (OutF, ’ \\newcommand{\\topiccode}{y.s}-\n’ .Topic.code) ; 
fprintf (OutF, ’ \\newcommand{\\topicname}{y.s}-\n’ .Topic.name) ; 
if isnumeric(Asst.number). 

fprintf (OutF. ’\\newcommand-[\\NAss}-{y,d}\n’ .Asst .number) ; 

else 

fprintf (OutF. ’\\newcommand-[\\NAss}-{Exam Paper}-\n’) ; 

end 

fprintf (OutF. ’ \\newcommand{\\Year}{y.d}-\n’ .Asst.year) ; 
fprintf (OutF. ’ \\newcommand{\\Semester}-{y,d}\n’ .Asst. semester) ; 
fprintf (OutF. ’ \\newcommand{\\DueDate}-[y,s}-\n’ . Asst. duedate) ; 
fprintf(OutF.’\\newcommand{\\PercentMarks}’); 
fprintf (OutF. ’{y.d}-\n’ .Asst.pmark) ; 

end 

fprintf (OutF. ’’/.sXn’ .deblank(ss) ) ; 

end 

fclose(af); 

clear ans af ss; 

y. End of processing of top-file 

fprintf (OutF.’y.y. End of top file.\n’); 


yx/x/x/x/x/x/x/x/x/x/x/x/x/x/xm 

y. Processing the spike-file 

uuuuuuuuuuuuuumx/x/x/x/xm^^^^^^^^^ 


AnsString =char(ones(Topic.NStud.MAX_NUMBER_0F_qUESTI0NS)*32); 
Numbers =char(ones(1.MAX_NUMBER_OF_QUESTIONS)*32); 

Weights =char(ones(l.MAX_NUMBER_0F_QUESTI0NS)*32); 

Neg_wts =char(ones(l.MAX_NUMBER_0F_QUESTI0NS)*32); 
ProblTypes=char(ones(l.MAX_NUMBER_0F_QUESTI0NS)*32); 
NAltAnswers=char(ones(l.MAX_NUMBER_0F_QUESTI0NS)*32); 


y.y;/.y;/.y;/.y;/.y;/.y;/.y;/.y;/.y;/.y;/.y;/.y;/.y;/.y;/.y.y;/.y;/;/.y;/.y;/;/.y;/.y.y^ 

y, start the main cycle 

y.y;/.y;/.y;/.y;/.y;/.y;/.y;/.y;/.y;/.y;/.y;/.y;/.y;/.y;/.y.y;/.y;/;/.y;/.y;/;/.y;^^ 

fprintf (OutF. ’ Wcatcode ‘@=ll\n’ ) ; 


y. This is a cycle of assignments. 


for n_00 = 1:Topic.NStud. 

fprintf (’Preparing variant y,d: ’.n_00); 
y. Prepare an assignment for nth student. 
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NSpkLn=0; 

spkfile=fopen(Asst.SpkFile); 
if spkfile==-l, 

fprintf(’Spike: Error.\n’); 

fprintfC’The file "/s is not found. \n’, Asst. SpkFile) ; 
return 

end 

CurrProbl=0; 


fprintf(DutF,’\n\\newpage\n’); 

fprintf (DutF, ’ \\renewcoiranand{\\@oddhead}-{-[\\small ’) ; 
if isnumeric(Asst.number), 

fprintf (DutF, ’ "/s Assignment "/,d \\ ’ .Topic. code, Asst .number) ; 
fprintf (DutF, ’ Variant "/d \\ "/,"/o\n’,n_00) ; 

fprintf (DutF, ’ "/d \\ Semester "/,d’, Asst .year, Asst. semester) ; 

else 


fprintf (DutF, ’ "/s Exam Paper "/,d’.Topic. code ,n_00) ; 

end 

fprintf (DutF. ’ Wquad Whfil {\\sf Student ID: ****’); 
ID_LEN=Topic.STUDENT_ID_LENGTH; 

fprintf (DutF. ’"/,s}}-}\n’ .Topic . StudentList (n_00. ID_LEN-2 : ID_LEN) ) ; 
fprintf (DutF. ’ \\setcounter{nques}-{0}-\n\n’) ; 


"/, This is a cycle of problems in eui assignment. 
while true. 


"/o"/i"/o Read one spike-block. 

uuuuuuuuuuuuuuumx/:/m^ 


"/o Fields of a spike-block: 

"/o Cmd: command. 

"/o NCmdPt: number of commands in the command part. 

"/o CmdPt: the command part of a spike-block. 

"/o NTxtPt: number of lines in the text part. 

"/o TxtPt: the text part of a spike-block. 

"/o AtPar: parameters of @-line. 

"/o TxtPrPar: parameters of the text part. 

"/o SpkLn: number of the current line in spike-file. 
[SB.status.NSpkLn]=ReadSpikeBlock(spkfile.NSpkLn); 


if strcmp(status.’error’). 
return 

elseif strcmp(status.’EOF’) I I feof(spkfile). 
"/, if end of spike file, then ... 
if n_00==l. 

Number_of_problems=CurrProbl; 

end 

break 

end 


"/o A spike-block «...>> has been read. 

uuuuuuuuuuuuuuumx/:/:/:/xm^^^^ 

y„ Processing of the spike-block. 


y.y.y.y.y.y.y.y.y.y.y.y.y.y.y.y.y.y. text y.y.y.y.y.y.y.y.y.y.y.y.y.y.y.y.y.y.y.y.y.y.y.y.y.y.y.y.y.y;/.y.y^^^ 

yxyxyxymyxyxymyxym^^^ 

if strcmp(SB.Cmd.’text’) . 
for k_00=l:SB.NTxtPt. 
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fprintf (OutF, ’"/os\n’ , deblank (SB. TxtPt (k_00,:))); 

end 

yx/:/x/x/x/x/x/xm data yx/x/x/x/x/x/x/x/x/xm^^ 
yx/x/x/x/x/x/x/x/x/x/x/x/x/x/XLyxm^^^^^^ 

elseif strcmpCSB.Cmd,’data’), 

rng(Asst.rcode+Asst.rseed*n_00); 

Q=datablock(SB); 

Q.ProcessCmdPt; 

yx/x/x/x/x/x/x/x/x/x/x/x/x/x/x/x/xm 

yx/x/x/x/x/x/x/xa problem z (void) yxixixixLyx/x/x/x/xm^^^^^^^^^ 

yxix/xixixixixix/xix/xix/xix/xmyxmyx^^^ 

elseif strcmp(SB.Cmd,’problemZ’), 

"/, in this case, do nothing 

yx/x/x/x/x/x/x/x/x/x/x/x/x/xmyxm^^^^^^^^^ 

yx/x/x/x/x/x/x/xa problems I, R, T, G, H, V "/X/X/X/X/X/X/X/X/X/X/X/X/X/. 

yx/x/x/x/x/x/x/x/x/x/x/x/x/x/x/x/x/x/x/x/x/x/x/x/x/x/x/x/x/x/x/x^^^ 

else 


Q=eval(sprintf (’"/,s (SB, OutF) ’ , SB .Cmd) ) ; "/, Constructor 
NR=evalin(’base’,’NRepeat’); 
for rep_00=l:NR, 

fprintf (OutF, ’\n\\problemtype{"/oc}\n’ ,Q.Cmd(8)) ; 
CurrProbl=CurrProbl+l; 

fprintf (’"/,d’,mod(CurrProbl, 10) ) ; "/ echo 
rng(Asst.rcode+Asst.rseed*n_00+CurrProbl); 

Q=Q.Execute; 

AnsString(n_00,CurrProbl)=Q.CorrAns; 


if n_00==l. 

Numbers(CurrProbl)=num2str(mod(CurrProbl, 10)); 
Weights(CurrProbl)=char(Q.Marks(1)+’0’); 
Neg_wts(CurrProbl)=char(Q.Marks(2)+’0’); 
ProblTypes(CurrProbl)=Q.Cmd(8); 
k=evalin(’base’,’NAltAns’); 

NAltAnswers(CurrProbl) = char(k+’0’); 

end 

end 

end 


yx/x/x/x/x/x/x/x/x/x/x/x/x/x/x/x/x/x/x/x/x/x/x/x/x/x/x/x/x/x/x^^^ 

yX/X/X/X/X/. End of spike block «...» processing ’/X/X/X/X/X/X/X/. 

yx/x/x/x/x/x/x/x/x/x/x/x/x/x/x/x/x/x/x/x/x/x/x/x/x/x/x/x/x/x/x^^^ 


end 

fprintf (OutF, ’•/,y,===============================================\n’ ) ; 

fprintf (OutF, ’•/,y,===============================================\n’ ) ; 

fclose(spkfile); 


fprintf(’ done.\n’); 

end 


fprintf(OutF,’\n\\catcode‘@=12\n\\end{document}\n’); 


fprintf (OutF, ’ \n"/,"/,=================================================== ’ ) ; 

fprintf (OutF,’\n"/o"/i============= Marking information =================’); 

fprintf (OutF, ’ \n"/,"/,=================================================== ’ ) ; 

fprintf (OutF,’\n\nRandom seed: "/XXn’, Asst. rseed’) ; 

fprintf(OutF,’\n\nThe following information is given ’); 
fprintf(OutF,’for marking purposes.\nThe line which ’); 
fprintf (OutF, ’ starts with "/"/iMARKING indicates beginning of ’); 
fprintf(OutF,’the marking\ninformation. The marking program ’); 
fprintf(OutF,’looks for this line and once it is found\nthe ’); 
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fprintf(OutF,’marking program starts the marking process.\nBefore the’); 

fprintf(OutF,’ seven dash line - correct answers are given.\n’); 

fprintf(OutF,’After - students amswers should be given.\n\n’); 


fprintf(OutF,’ 
fprintf(OutF,’ 
fprintf(OutF,’ 
fprintf(OutF,’ 
fprintf(OutF,’ 
fprintf(OutF,’ 
fprintf(OutF,’ 
fprintf(OutF,’ 
fprintf(OutF,’ 


PrbType: types of questions: A,B,C,F or G (in version L3).\n’); 
Numbers: the last digit of the number of question.\n’); 

Weights: mark for a correct answer.\n’); 

Neg wts: penalty for an incorrect answer.\n’); 

Specfcs: specifications for marking:\n’); 

(a) "+" consider am answer as correct (for whatever reason).\n’); 

(b) "0" ignore the question, that is, give no marks for it.\n’); 

(c) "n" do not show the right answer for this question.\n’); 

(d) or " " treat the question as usual.\n\n’); 


fprintf (OutF, ’Topic code: "/os\n’,Topic . code) ; 

if isnumeric(Asst.number), 


fprintf(OutF, 

else 

’Assignment number: 

’/.d\n’ ,Asst .number) ; 

fprintf(OutF, 

end 

’Exam paper.\n’); 



fprintf (OutF, ’Number of questions: "/od\n\n’,Number_of_problems) ; 


fprintf (OutF, ’PrbType :"/os\n’ ,ProblTypes) ; 
fprintf (OutF, ’NAltAns :"/os\n’ ,NAltAnswers) ; 
fprintf (OutF, ’ y.y.MARKINGXn’ ) ; 
fprintf (OutF, ’Numbers :"/os\n’ ,Numbers) ; 

fprintf (OutF, ’ Specfcs :"/os\n’ , char (ones (1, Number _of_problems) * ’.’)); 
fprintf (OutF, ’Weights :"/os\n’ ,Weights) ; 
fprintf (OutF, ’Neg wts: "/,s\n’,Neg_wts) ; 
for n=l:Topic.NStud, 

fprintf (OutF, ’’/.s : °/.s\n’ ,Topic . StudentList (n, : ) , AnsString(n, :) ) ; 

end 

fprintf (OutF, ’-\n’); 

fprintf (OutF, ’"/"/ilnsert here students’’ answers. \n’) ; 
fclose(DutF); 


"/o cd(currdir) ; 
fprintf(’Done.\n\n’); 

edit(OutFile); 


end "/, spike 
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classdef assignment 


properties 
topic; 
number; 
pmark; 
year; 
semester; 
duedate; 
rcode; 
rseed=57; 

SpkFile; 

end 


y, mark for this assignment in percents. 


y, random code 

y, random seed. These two numbers are used to 
y, initialize Matlab’s generator of random numbers. 


methods 

function A=assignment(topicO.numberO) 
if (nargin>0), 

A.topic=topicO; 

A.number=numberO; 

A.pmark=evalin(’base’,’PercentMarks’); 

A.rseed=evalin(’base’,’rseed’); 

A.duedate=evalin(’base’,’duedate’); 

c=clock; A.year=round(c(l)); 
if c(2)<=6, 

A.semester = 1; 

else 

A.semester = 2; 

end 

"/o Remdom code of the assignment: YEAR + SEMESTER. 

A.rcode=A.year*10+A.semester; 
end y, if (nargin>0) 

if isnumeric(A.number), 

A. SpkFile=sprintf ( ’"/.sWy.sAyod. spk’ , A. topic. code, A. topic. code, A .number) ; 
elseif A.number==’E’, 

A. SpkFile=sprintf (’’/.sW’/.sEx. spk’ , A. topic . code, A. topic . code) ; 

else 

fprintf(’Spike: Error.\nThe second argument must ’); 
fprintfC’be a number or ’’E’’ character.\n’); 
return 

end 

end y, function assignment 
end y, methods 


end 
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classdef datablock < spikeblock 
methods 

function q=datablock(S) 

q=q@spikeblock(S.SpkLn,S.Cmd,S.CmdPt,S.NCmdPt,S.TxtPt,S.NTxtPt,S.AtPar); 

end 

function q=ProcessCmdPt(q) 

’/. Evaluate commands of the command part. 

’/. If an attempt to evaluate fails, give an error message, 
for k=l:q.NCmdPt, 

out = q.CmdPt(k,:); 
try 

Spike2Matlab(out); 
catch ME 

q.ME_Error(out,ME); 

end 

end 

end 

end 

end 
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classdef problem < spikeblock 

’/. problem is the superclass of problemi, problemR, etc 

•/. 


properties 

NAltAnswers; 
outfile; ’/. 

CorrAns; ’/. 

TxtPtPar; ’/. 

Marks; ’/. 

•/. 


"/o number of alternative answers A,B,C,... 
the output LaTeX file 

correct answer, one of these: A,B,C,... 
parameters 

marks(l) is the mark for correct answer, 
-markts(2) is the mark for incorrect answer. 


end 


methods 

function q=problem(S,outfileO) 

q=q@spikeblock(S.SpkLn,S.Cmd,S.CmdPt,S.NCmdPt,S.TxtPt,S.NTxtPt,S.AtPar); 
q. outf ile=outf ileO; 

[vars,num]= SeparateVariables(q.AtPar 
if num<3, 

fprintf (’\nSpike: ERROR in line ’/.d: ’ ,q. SpkLn) ; 
fprintfC’ O-line must have at least two semicolons.\n’); 
return 

end 

q.AtPar=strtrim(vars(1,:)); 
q.TxtPtPar=,strtrim(vars(2,:))]; 
if num>=4, 

ss=strtrim(vars(3,:)); 
q.NAltAnswers= ss(1)-’0’; 
else 

q.NAltAnswers=evalin(’base’,’NAltAns’); 

end 

end 

function q=Execute(q) 
q=q.ProcessCmdPt; 
q=q.SetRandPerm; 
q=q.SetCorrAns; 
q=q.WriteAtLine; 
q=q.ProcessTxtPt; 
q=q.ProcessAnswers; 

end 

function Sp_Error(q,message,str) 

fprintf(’\n\n\nSpike: error in spike-block ’); 

fprintf (’starting at line ’/,d in spk-file.\n’,q.SpkLn) ; 

fprintf (’Spike-block type: °/,s\n’,q.Cmd) ; 

fprintf ( ’Message : \n ’/.s\n’ ,message) ; 

fprintf (’Line with error :\n ! °/,s ! \n’, str) ; 

fprintf(’Press Ctrl+Pause to terminate the program.\n’); 

pause; 

end 

end 

methods (Access = protected) 

function q=SetCorrAns(q) 
end 

function q=SetRandPerm(q) 
end 
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function q=ProcessCmdPt(q) 
end 

function q=WriteAtLine(q) 

[vans,len]=SeparateVariables(q.AtPar,’,; 
q.Marks=zeros(1,max(2,len)); 
q.Marks(l)=str2double(vars(1,:)); 
q.Marks(2)=0; 
for j=2:len, 

q.Marks(j)=str2double(vars(j,:)); 

end 

fprintf (q. outf ile, ’ \\probl’/.c-[°/,c]-’ , ’ A’ - l+len,q. CorrAns) ; 
for j=l:len, 

fprintf (q. outf ile, ’ {"/d]-’ .q.Marks (j ) ) ; 

end 

fprintf(q.outfile, ’ \n’); 

end 

function q=ProcessTxtPt(q) 
end 

function q=ProcessAnswers(q) 
end 


end 

end 
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classdef problemG < problem 
properties 

nques; "/, number of statements to be chosen 

nchosentrue; "/ number of true statements in a chosen random sample 

end 

methods 

function q=problemG(S,outfileO) 
q=q@problem(S,outfileO); 

"/, Number of true/false statements which are to be chosen; 

"/, this number is given at @ line as third number. 

"/, For example, @2,0;7; meauis we have to choose 7 statements, 
if ismember(q.TxtPtPar(2:end),’0123456789 ’ ) , 
q.nques=str2double(q.TxtPtPar(2:end)); 

else 

q.Sp_Error(’Incorrect format of the @-line’,q.TxtPtPar(2:end)); 

end 

end 

end 

methods (Access = protected) 


function q=SetCorrAns(q) 

q.CorrAns=char(64+randi(q.NAltAnswers)); 

end 

function q = ProcessTxtPt(q) 

"/, Write the body of the multiple choice question; 

"/, it is of this kind: ‘‘How many of the following 
"/, statements are true?’’ 
for k=l:q.NTxtPt, 

fprintf (q. outf ile, ’"/,s\n’ ,deblank(q.TxtPt (k, : ) ) ) ; 

end 

"/, nchosentrue is the number of right statements chosen rauidomly. 
q.nchosentrue=0; 

fprintf(q.outfile,’\\begin{enumerate}\n’); 
for k=l:q.nques, 

[s,b]=eval(q.CmdPt(1,:)); 

fprintf (q. outf ile, ’ Witem "/os\n’ , s) ; 

q.nchosentrue=q.nchosentrue+b; 

end 

fprintf(q.outfile,’\\end{enumerate}\n\n’); 

end 


function q=ProcessAnswers(q) 

"/, Get multiple choice answers. 

pp=MCQAnswers(q.nchosentrue,q.CorrAns-64,0,q.nques,q.NAltAnswers); 

"/, Print multiple choice answers. 
for k=l:q.NAltAnswers, 

fprintf (q. outf ile,’("/oc) \\ "/,d Wquad \n’, char (64+k) ,pp(k) ) ; 

end 

end 


end 
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end 


iivauuui Subfunctions 


function 

pp=MCQAnswers(NChosenTrue,CorrAnsPos,LowBound,UpperBound,NAltAns) 

"/o This function returns a string of multiple choice answers. 

"/o Here NChosenTrue is the correct answer, for example, 7; 

"/o CorrAnsPos is the position of this correct answer, for example, 4; 

"/o LowBound and UpperBound are lower and upper bounds for the other four 
"/o alternative wrong answers, for example, LowBound =0 and UpperBound=9. 
"/o Then for NAltAns=5 MCQAnswers will produce something like 
•/. (A) 2 (B) 0 (C) 8 (D) 7 (E) 5 

"/o a is a random set of NAltAns-1 n\imbers 

"/o chosen from the set LowBound. .UpperBound \ NChosenTrue. 
a=LowBound-l+randperm(UpperBound-LowBound,NAltAns-l); a = a + 
(a>=NChosenTrue); 

pp=[a(l:CorrAnsPos-1),NChosenTrue,a(CorrAnsPos:NAltAns-1)]; end 
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classdef problemH < problemG 
methods 

function q=problemH(S,outfileO) 
q=q@problemG(S,outfileO); 

end 

end 

methods (Access = protected) 


function q=ProcessCmdPt(q) 

’/, Execute commEuids of the commEuid part. 

’/. If an attempt to execute fails, give eui error message, 
for k=l:q.NCmdPt, 

out = q.CmdPt(k,:); 
try 

Spike2Matlab(out); 
catch ME 

q.ME_Error(out,ME); 

end 

end 

end 

function q = ProcessTxtPt(q) 

’/. Write the body of the multiple choice question; 

’/. it is of this kind: ‘‘How many of the following 
’/. statements are true?’’ 
for k=l:q.NTxtPt, 

fprintf (q. outf ile, ’"/,s\n’ ,debl£uik(q.TxtPt (k, : ) ) ) ; 

end 

’/. nchosentrue is the number of right statements chosen randomly, 
q.nchosentrue=0; 

fprintf (q. outf ile, ’ \\begin-[enumerate}-\n’) ; 
for k=l:q.nques, 

q.ProcessCmdPt; 

s=evalin(’base’,’out’); 

fprintf (q. outf ile, ’ Witem "/os\n’ , s) ; 

q.nchosentrue=q.nchosentrue+evalin(’base’, ’tf’) ; 

end 

fprintf (q. outf ile, ’ \\end-[enumerate}\n\n’ ) ; 

end 


end 


end 
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classdef problemi < problem 
properties 

RandPerm; °/, random permutation of answers. 

answer; °/, the answer string which CmpPt returns upon execution. 

end 

methods 

function q=problemI(S,outfileO) 
q=q@problem(S,outfileO); 

end 


end 

methods (Access = protected) 

function q=SetRandPerm(q) 

q.RandPerm = randperm(q.NAltAnswers); 

end 

function q=SetCorrAns(q) 

"/, We choose a random permutation of answers so that 
"/, RandPerm(CorrAns)=l. 
for k=l:q.NAltAnswers, 
if q.RandPerm(k)==l, 

q.CorrAns=char(64+k); 
break 

end 

end 

end 

function q=ProcessCmdPt(q) 

"/, Execute commEuids of the command part. 

"/, If an attempt to evaluate fails, give an error message, 
for k=l:q.NCmdPt-1, 

out = q.CmdPt(k,:); 
try 

Spike2Matlab(out); 
catch ME 

q.ME_Error(out,ME); 

end 

end 

£uisstr=q.CmdPt (q.NCmdPt, : ) ; 
ansstr=strtrim(ansstr); 

if length(ansstr) < 7 || ~strcmp(ansstr(1:7)answer(’), 
q.Sp_Error(’Answer operator is expected’,ansstr); 

else 

q.answer=evalin(’base’,[’sprintf’,ansstr(7:end)]); 

end 

end 

function q=ProcessTxtPt(q) 
params=q.TxtPtPar; 
for k=l:q.NTxtPt, 

ss=deblank(q.TxtPt(k,:)); 
ss=strrep(ss,’\; 
ss=strrep(ss 


"/o Get number of parameters. 
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NuinQfPercents=suin(ismember(ss, ; 

[pars ,parains] =GetParaineters (NumOfPercents, params) ; 
if strcmp(params,’!ERROR!’), 

msg=’Insufficient number of parameters.’; 
q.Sp_Error(msg,q.TxtPtPar(2:end)); 

end 

"/o Print the line of the text part to the output 
"/o LaTeX file, processing the parameters. 


out= [’ sprintf ( ’ ’ ’ , ss, ’ ’ ’ ’ ,pars 
try 

outstr=evalin(’base’,out); 
catch ME 

q.ME_Error(out,ME); 

end 

fprintf (q.outfile, ’"/,s\n’ .outstr) ; 

end 

if “isempty(params), 

msg=’Too many parameters.’; 
q.Sp_Error(msg,q.TxtPtPar(2:end)); 

end 

end 

function q=ProcessAnswers(q) 

MAX_ANSWER_LENGTH=147; 

Good_Answer_Attempts=evalin(’base’,’GOQD_ANSWER_ATTEMPTS’); 
£uisw=char(ones(q.NAltAnswers,MAX_ANSWER_LENGTH)*32) ; 
£uislen=zeros(l,q.NAltAnswers) ; 
nattempts=0; 

Euislen(l)=length(q.answer) ; 
if anslen(l) > MAX_ANSWER_LENGTH, 

q.Sp_Error(’answer line is too long’,q.answer); 
elseif anslen(l) ==0, 

q.Sp_Error(’answer line is empty’,’’); 

end 

Euiswd, 1: anslen(l) )=q. answer; 

for m=2:q.NAltAnswers 

while nattempts<1000, 
q=q.ProcessCmdPt; 

"/, Check that the current answer is different 
"/, from the previous ones. 
answer_is_good=true; 
for j=l:m-l, 

if strcmp(q.answer,answ(j,1:anslen(j))), 
answer_is_good=false; 
break 

end 

end 

if answer_is_good, 

anslen(m)=length(q.answer); 
if anslen(m) > MAX_ANSWER_LENGTH, 

q.Sp_Error(’answer line is too long’,q.answer); 

end 

answ(m, 1: anslen(m) )=q. Euiswer; 
break 

else 


nattempts=nattempts+l; 
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if nattempts>=Good_Answer_Attempts, 

fprintf(’\nSpike: too many attepmts to ’); 
fprintf (’find a non-repeating aoiswer. \n ’ ) ; 
fprintf (’q.NAltAnswers: °/.d\n’ ,q.NAltAnswers) ; 
fprintf(’\nContinue? (Y/N)’); 
yn=input ’ s’) ; 
if (yn==’Y’) I I (yn==’y’), 

fprintf(’\nSpike: I’’ll try 50 more times.\n’); 
Good_Answer_Attempts=Good_Answer_Attempts+50; 

else 

fclose(q.outfile); 

fprintf(’The program has been terminated.\n’); 
return 

end 

end 

continue 

end 

end 

end 


fprintf(q.outfile,’\n\\medskip\\noindent\n’); 

’/. Write Multiple Choice answers, 
for k=l:q.NAltAnswers, 
ik=q.RandPerm(k); 

fprintf (q. outfile,’("/oc) \\ ’ , char (64+k) ) ; 
fprintf (q. outfile, ’"/,s ’ , answ(ik, 1: anslen(ik) ) ) ; 
fprintf (q. outfile, ’ Wquad \n’); 

end 

fprintf(q.outfile,’\n’); 

end 

end 


end 

function [ss,s2]=GetParameters(n,params) 
ss=’ ’ ; 
for j=l:n, 

[a,params]=strtok(params 
if isempty(a), 

s2=’!ERROR!’; 
return 

end 

ss=sprintf ( ’"/,s //s ’ , ss, a) ; 

end 

s2=params; 
end 
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classdef problemR < problemi 

properties 

lastdigit; 

end 

methods 

function q=problemR(S,outfileO) 
q=q@problemI(S,outfileO) ; 

end 


end 

methods (Access = protected) 


function q=SetRandPerm(q) 

’/, the identity permutation 
q.RandPerm = 1:q.NAltAnswers; 

end 

function q=SetCorrAns(q) 

anssize=length(q.answer); 

if "ismember(q.answer(anssize), ’ 1234567890’), 

q.Sp_Error(’Answer string must end by a digit’,q.answer); 

end 

q.lastdigit=str2double(q.answer(anssize)); 
q.CorrAns=char(floor(q.lastdigit/2) + 65); 

end 


function q=ProcessAnswers(q) 

fprintf(q.outfile,’\n\\medskip\\noindent\n’); 

’/. Write Multiple Choice answers, 
if mod(q.lastdigit,2)==0, 
lastchar=’02468’; 

else 

lastchar=’13579’; 

end 

for m=l:q.NAltAnswers, 

fprintf (q. outf ile,’("/oc) \\ ’ , char (64+m) ) ; 
fprintf (q. outf ile, ’ $"/oS ’ ,q. answer (1: end-1) ) ; 
fprintf (q. outf ile, ’"/,c$\\quad\n’ , lastchar (m) ) ; 

end 

fprintf(q.outfile,’\n’); 

end 

end 


end 
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classdef problem! < problemG 
properties 

ntrue; "/, number of true statements 
nfalse; "/, number of false statements 
p_00; "/, random sample of statements 

end 

methods 

function q=problemT(S,outfileO) 
q=q@problemG(S,outfileO); 

end 


end 

methods (Access = protected) 

function q = ProcessCmdPt(q) 

MAX_C0MMAND_LENGTH=780; 
for j=l:q.NCmdPt, 

"/o Process jth line of the command part. 
s_00=ProcessFString(q.CmdPt(j,:)); 
q.CmdPtCj,:)=char(ones(l,MAX_C0MMAND_LENGTH)*32); 
q.CmdPt(j,1:length(s_00))=s_00; 

end 

’/. The lines which follow after @ line are for 
’/. the question body. The @ line itself in type T 
’/. question must have the format @N1 [ ,N2 [ ,N3] ] ; k; 

’/, where k is the number of statements to choose. 

q.ntrue=0; 

for j=l:q.NCmdPt, 

if strcmpCq. CmdPt (j , 1:7) , ’-’), 

q.nfalse=j-l; 

q.ntrue=q.NCmdPt-q.nf alse-1; 
break 

end 

end 

if q.ntrue==0, 

q.Sp_Error(’False and true statements should be seperated by-’, ,q.AtPar] 

end 

"/, Decide which statements to pick up 
q. p_00=rEuidperm(q. nf alse+q.ntrue, q. nques) ; 

"/, skip ‘‘seven dash’’ (that is,-) line 

q.p_00 = q.p_00 + (q.p_00>q.nfalse); 

"/, number of correct statements chosen. 
q.nchosentrue=sum(q.p_00>q.nfalse); 

end 

function q = ProcessTxtPt(q) 

"/, Print a sentence of this kind: 

"/, ‘‘How many of the following statements are true?’’, 
for k=l:q.NTxtPt, 

fprintf (q. outf ile, ’"/,s\n’ ,deblank(q.TxtPt (k, : ) ) ) ; 

end 

fprintf (q. outf ile, ’\\begin{enumerate}-\n’) ; 
for k=l:q.nques, 

fprintf (q. outf ile,’Witem ’); 
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fprintf (q. outf ile, ’"/,s\n’ ,deblank(q. CmdPt (q.p_00(k) ,:))); 

end 

fprintf (q. outf ile, ’ \\end-[enumerate}\n\n’ ) ; 

end 


end 


end 


subfunctions 


function outss=ProcessFString(inss) 

y. This function is used to process lines in questions of type problemT. 

if strncmpCinss, ’- ’.7), 

outss=inss; 

else 

[a,b]=strtok(inss,’0’); 
b=strtrim(b); 
if isempty(b), 
outss=a; 
return 

end 

b=ProcessCurvedBrackets(b(2:end)); 
if isempty(b), 
outss=a; 

else 

a=strrep(a,’\; 
a=strrep(a,>>>> ^ >>>>>>); 
str0=[’sprintf(’’’,a,’’’,’,b, 
try 

outss=eval(strO); 
catch ME 

fprintf (’\nSpike : ERROR in line ’’’/.s’’ :\n’,inss) ; 
fprintf ( ’y,s\n’ ,ME. identifier) ; 
fprintf ( ’y,s\n’ ,ME.message) ; 

error (’The program is halted due to eui error.’); 

end 

end 

end 

end 
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classdef problemV < problem 

properties 

end 

methods 

function q=problemV(S,outfileO) 
q=q@problem(S,outfileO); 

end 


end 

methods (Access = protected) 

function q=SetCorrAns(q) 

q.CorrAns=q.TxtPtPar(2); 

end 

function q=ProcessTxtPt(q) 
y, q. AtPar=deblank(q. AtPar) ; 

y, if (lengthCq. AtPar) <5) I I (isempty (intersect (q. AtPar (5) ,’ABCDEFGH’))) , 

y, q. Sp_Err or (’wrong or missing answer’, [’S’,q. AtPar] ) ; 

y, end 

for k=l:q.NTxtPt, 

fprintf (q. outf ile, ’"/.sXn’ ,debl£uik(q.TxtPt (k, : ) ) ) ; 

end 

fprintf(q.outfile,’\n’); 

end 


end 


end 
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function outss=ProcessCurvedBrackets(inss) 

"/o if the string inss contains the substring ’sprintf’ 

"/o then do nothing. 
s=strfindCinss,’sprintf’); 
if ~isempty(s), 
outss=inss; 
return 

end 

"/, if the string inss does not contain curved brackets 
"/o then do nothing. 

[a,b]=GetPairDfCurvedBrackets(inss); 
if a==0, 

outss=inss; 
return 

end 

pp=evalin( ’base ’ , sprintf ( ’ ["/s] ’ , inss (a+1 :b-l) ) ) ; 
len=length(pp); 
nn=pp(randi(len)); 

outss=sprintf ( ’"/,s"/,d"/,s ’ , inss (1: a-1) ,nn, inss (b+1: end) ) ; 
outss=ProcessCurvedBrackets(outss); 
end 

function [a,b]=GetPairOfCurvedBrackets(inss) 

"/o a and b are indices of the first inner pair of brackets { and }. 
"/o For example, if inss=’a=-[3: {4:10}}’ , then a = 6 and b = 11. 
a=0; b=0; n=length(inss); for j=l:n, 
if inss(j)==’{’, 

a=j; 

elseif inss(j)==’}’, 
if a==0, 

error(’Unbalanced pair of curved brackets {...}.’); 

else 

b=j ; 

return 

end 

end 

end 

end 
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function [SB,status,SpkLn]=ReadSpikeBlock(spkfile,SpkLn) 

"/o This function reads one spike-block «...» from a text file spkfile, 

"/o and returns it in the spike-block SB. 

•/. Last edited on 27/11/2014. 

1 

1 

"/o Input: a pointer is at line SpkLn outside a spike-block of a file spkfile. 

•/. 

"/o Output: one spike-block <<...» is read into SB and the pointer is at 
"/o last line of this spike-block. 

•/. 


MAX_NUMBER_DF_CDMMANDS=500; 

MAX_CDMMAND_LENGTH=780; 

MAX_NUMBER_DF_PRQBLTXT=87; 

MAX_PRQBLTXT_LENGTH=237; 

Cmd=’EQF’; 

CmdPt=’’; 

NCmdPt=0; 

TxtPt=’’; 

NTxtPt=0; 

AtPar=’’; 
status=’’; 

SB=’ ’ ; 

"/o Read eui opening command << and the Cmd name, 
while true, 

if feof(spkfile), 
status=’EQF’; 
return 

else 

s=fgetl(spkfile); 
s=deblank(s); 

SpkLn=SpkLn+l; 

if (length(s)>=2) && (strcmp(s(1:2),’<<’)), 

SpkLnO=SpkLn; 
if s(end)~=’;’, 

fprintf ( ’ \nSpike: error in line "/,d: ; is expected at the end of line. \n’,SpkLn) ; 

status=’error’; 

return 

else 

Cmd=s(3:end-1); 
break 

end 

elseif (length(s)>=4) && (strcmp(s(l: 4) ,’"/.EOF’) ) , 
status=’E0F’; 
return 

end 

end 

end 

if ~strcmp(Cmd,’data’) && ~strcmp(Cmd,’text’), 

if ~strcmp(Cmd(l:7),’problem’) I I isempty(intersect(Cmd(8),’GHIRVTZ’)), 

fprintf (’\nSpike: error in line ’/.d: after « one of the following commands is expected: \n’,SpkLn) ; 
fprintf(’data, text, problem[G,H,I,R,V,T,Z].\n’); 
status=’error’; 
return 

end 


end 
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y.y.y. Read the command part CmdPt of spike-block. 

uuuuuuuuuuvamxm:aTamm^^^ 

y. The command part CmdPt is what comes between « and 


y, Here we are inside « ... » 


y. If the spike block is not a text-block, then read 
y, the command part of the spike block, 
if "strcmpCCmd,’text’), 

y. Initialize CmdPt as an array of MAX_NUMBER_OF_COMMANDS empty commands, 
y. 32 is the code of empty space character. 

CmdPt=char(ones(MAX_NUMBER_OF_COMMANDS,MAX_COMMAND_LENGTH)*32); 


while true, 

if feof(spkfile), 

fprintf (’ \nSpike: error in line ’/.d: @ or » is expected.\n’,SpkLn) ; 

status=’error’; 

return; 

else 

s=fgetl(spkfile); 
s=deblank(s); 

SpkLn=SpkLn+l; 

if (length(s) >=4) && (strcmp(s (1:4) ,’’/.EOF’) ) , 

fprintf (’\nSpike: error in line ’/,d: @ or >> is expected. \n’ ,SpkLn) ; 

status=’error’; 

return 

end 

end 


y, Here s is a current non-empty line from a spike-file, 
if ~isempty(s) && s(l)==’’/,’, 

continue 


elseif ~isempty(s) && strcmpCs(1),’O’), 
if StrcmpCCmd,’data’), 

fprintf (’\nSpike: error in line ’/.d: » was expected, 0 was f ound. \n’, SpkLn) ; 
fprintf (’\nData spike-block should not have 0...» part.\n’); 
status=’error’; 
return 

else 

break ’/, from « ... 0 

end 


elseif length(s)>=2 && strcmp(s(l:2),’»’), 
break ’/, from « ... » 

else y, read the command lines between « and 0 
len=length(s); 

while ~isempty(s) && s(len)==’y,’, 
if f eof (spkf ile) , 

fprintf (’\nSpike: error in line ’/.d: 0 or » is expected.\n’,SpkLn) ; 

status=’error’; 

return 

end 

t=fgetl(spkfile); 

SpkLn=SpkLn+l; 
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s=[s(l:len-1),t]; 
len=length(s); 

end 

if length(s)>MAX_COMMAND_LENGTH, 

fprintf ( ’ \nSpike: a command length is larger tham ’/.d. ’ , MAX_CDMMAND_LENGTH) ; 

status=’error’; 

return 

end 

NCmdPt=NCmdPt+l; 
if ~isempty(s), 

CmdPt(NCmdPt,1:length(s))=s; 

end 

end 

end 

CmdPt=CmdPt(1:NCmdPt,:); 

end ’/o if ~strcmp(Cmd,’text ’ ) 

if ~isempty(s) && strcmp(s(l) , 

AtPar=s(2:end); 

end 

"/o At this stage we are inside a subblock @...>> 

"/o or inside a text-block «...>>. 

"/o Read the text part of «. . .» to the array TxtPt. 

"/o The text part is what comes between @ and » 

if ~strcmp(Cmd,’data’), 

TxtPt=char(ones(MAX_NUMBER_OF_PROBLTXT,MAX_PROBLTXT_LENGTH)*32); 

while true, 

if feof(spkfile), 

error(’Spike: » is expected’); 

end 

"/o read a line, ignoring comments. 
s=fgetl(spkfile); 
s=deblank(s); 

SpkLn=SpkLn+l; 

if ~isempty(s) && s(l)==’"/,’, 
continue 

end 

if (length(s)>=4) && (strcmp(s (1:4) ,’"/EOF’) ) , 

fprintf (’\nSpike: error in line °/d: @ or » is expected. \n’,SpkLn) ; 

status=’error’; 

return 

end 

if (length(s)>=2) && (strcmp(s(1:2),’>>’)), 

’/ if this is the end of the problem part, ... 
break 

else 

NTxtPt=NTxtPt+l; 
if ~isempty(s), 

TxtPt(NTxtPt,1:length(s))=s; 

end 

end 


end 
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TxtPt=TxtPt(1:NTxtPt,:); 
end ’/o if ~strcmp(Cmd,’data’) && ... 

SB=spikeblock(SpkLnO,Cmd,CmdPt,NCmdPt,TxtPt,NTxtPt,AtPar); 
end 
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function [vans,len]=SeparateVariables(ss,sep) 

"/o For example, if sep==’,’ and ss==’al,xy,k’ 

"/o this function will return len=3 and vars(l) = ’al’, 
"/o vars(2) = ’xy’ and vars(3) = ’k ’ . 

•/. 


ss(ss==’ 

seppos=[0,strfind(ss,sep),length(ss)+l]; 
len=sum(ss==sep)+l; 
vars=char(ones(len,20)*32); 
for j=l:len, 

vars(j,1:seppos(j+l)-seppos(j)-l)=ss(seppos(j)+l:seppos(j+l)-l); 

end 

end 
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function Spike2Matlab(inss) 

"/o Generally, a Spike command is just a Matlab command, but with 
"/o one exception. This function transforms that exceptional 
"/o Spike command into Matlab format. 

1 

"/o Specifically, 

"/o if a spike-command sb has a pair of curved brackets {...}■ 

"/o then this function replaces them by a number, 

"/o chosen randomly from the list of numbers inside the curved brackets. 

1 

"/o For example, a command such as 

•/. 

•/. a=[{3:7},{3,5,7,ll>] ; 

•/. 

"/o will be replaced in one run by, say, a=[6,7], 

"/o in another run by, say, a=[4,ll], etc. 

•/. 

"/o Input: sb, a string with a Spike operator; 

"/o Output: sa, a string with a MATLAB operator. 

if MultipleAssign(inss), 

outss=ProcessCurvedBrackets(inss); 
evalinC’base’,outss); 

end 

end 


function bool=MultipleAssign(ss) 
bool=0; 

inss=strtrim(ss); 
order = 0; 

k=strfindCinss,’!=’); 
if isempty(k), 

k=strfindCinss 
if isempty(k), 
bool=l; 
return 

else 

order = 1; 

end 

end 

if length(k)>l, 

errorC [’Incorrect multiple assignment operator(l): ’,inss]); 

end 

if "strcmpCinss (end-1: end) ) I I "strcmpCinss (k+2) ,’■[’) , 

error( [’Incorrect multiple assignment operator(2): ’,inss]); 

end 

pp=evalin( ’base ’ , sprintf ( ’ [’/.s] ’ , inss (k+3: end-2) ) ) ; 

[vars,lenvar]=SeparateVariables(inss(1:k-l),’,’); 
if lenvar==l, 

error(’At least two variables are expected.’); 

end 

ind=randperm(length(pp),lenvar); 
a=pp(ind); 
if order, 

a = sort(a); 
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end 

if isnumeric(a(l)) , 
for j=l:lenvar, 

evalinC ’base ’ , sprintf ( ’"/,s="/od; ’ , deblank (vars (j,:)),a(j))); 

end 

else 

for j=l:lenvar, 

evalinC ’base’ , sprintf (’’/.s=’ ’°/.c ’ ’ ; ’ , deblank (vars (j,:)),a(j))); 

end 

end 

end 
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classdef spikeblock 
properties 


SpkLn; 

’/, the 
•/. 

number of the line in a spike-file 
where this block starts. 

Cmd; 

"/, one 
•/. 

of these: data, text, problemR, problemi 
problem!, problemV or problemG 

CmdPt; 

’/. the 
•/. 

command part of spike-code; 

this is what comes between « and @ 

NCmdPt; 

’/, the 

number of lines in the command part; 

TxtPt; 

’/. the 
•/. 

text part of spike-code; 

this is what comes between @ and » 

NTxtPt; 

’/. the 

number of lines in the text part; 

AtPar; 

end 

methods 

’/. This is the line in the block 

’/, which starts with @ character; 


function q=spikeblock(spkLn,cmd,cmdPt,nCmdPt,txtPt,nTxtPt,atPar) 
q.SpkLn=spkLn; 
q.Cmd=cmd; 
q.CmdPt=cmdPt; 
q.NCmdPt=nCmdPt; 
q.TxtPt=txtPt; 
q.NTxtPt=nTxtPt; 
q.AtPar=atPar; 

end 

function ME_Error(q,str,ME) 

fprintf(’\n\n\nSpike: error in spike-block ’); 
fprintf (’starting at line ’/,d in spk-file.\n’.q.SpkLn) ; 
fprintf (’Spike-block type: "/os\n’,q.Cmd) ; 
fprintf (’Line with error :\n ! "/s ! \n’, str) ; 

fprintf ( ’°/,s\n’ ,ME. identifier) ; 
fprintf ( ’°/,s\n’ ,ME.message) ; 

fprintf(’Press Ctrl+Pause to terminate the program.\n’); 
pause; 

end 

end 


end 
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classdef topic 

properties (Constaiit=true) 

MAX_NUMBER_0F_STUDENTS=500; 

STUDENT_ID_LENGTH=7; 

end 

properties 
code; 
name; 

NStud; 

student sfilename; 
sfile; 

StudentList; 

end 

methods 

function t=topic(topiccode) 

topiccode=upper(topiccode); 
t.code=topiccode; 

if strcmp(topiccode,’MATH2712’), 
t.name=’Algebra’; 

elseif strcmp(topiccode,’MATH3712’), 

t.name=’Partial Differential Equations’; 
elseif strcmp(topiccode,’MATH3701’), 
t.name=’Numerical Analysis’; 
elseif strcmp(topiccode,’MATH4709’), 
t.name=’Topology’; 

else 

t.name=’Unknown Topic Code’; 

end 

t. students!ilename=sprintf (’’/.s\\°/,s . txt ’ , t. code, t. code) ; 

t.sfile=fopen(t.students!ilename); 
if t.sfile==-l, 

error(’Spike: student file is not found.’); 

end 

’/. NStud is the number of students. 
t.NStud=0; 

’/. 48 is the code of the character ‘‘O’’ 

t.StudentList=char(ones(t.MAX_NUMBER_OF_STUDENTS,t.STUDENT_ID_LENGTH)*48); 

’/, Read the student ID’s from the student 
’/. ID file to the array StudentList. 
while ~feof(t.sfile) , 

ss=fgetl(t. sf ile) ; "/, ID of a student 
if length(ss) >= 1 && ss(l)==’"/,’, 
continue 

elseif length(ss)<t.STUDENT_ID_LENGTH, 

fprintf(’Spike: error in a student list file:\n’); 
fprintf(’ y.s . \n’, ss) ; 

fprintf(’In a student list file lines cannot have ’); 
fprintf (’length less than "/.d. ’ ,t. STUDENT_ID_LENGTH) ; 

elseif strcmp(ss(1:7) , ’-’), 

break 

else 

t.NStud=t.NStud+1; 

t.StudentList(t.NStud,:)=ss(1:t.STUDENT.ID_LENGTH); 


"/o number of students enrolled in this topic. 

y, file with list of students enrolled in this topic. 

"/o file variable for students!ilename. 


end 
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end 

fclose(t.sfile); 

’/, removing empty (zero) lines 
t.StudentList=t.StudentList(1:t.NStud,:); 

’/. Sort StudentList before starting to do anything with it. 

t.StudentList=mysort(t.StudentList,t.STUDENT_ID_LENGTH-2,t.STUDENT_ID_LENGTH); 
t.StudentList=t.StudentList(:,1:t.STUDENT_ID_LENGTH); 
end ’/, function topic (constructor) 

end 

end 
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8. Appendix C: Example of top-file 

The following example of top-file shows what kind of information may go into top-file. 

duedate=’Sunday, 9 November 11pm’; 
rseed=247; °/, Random seed of the assignment. 

PercentMarks=10; 

NAltAns=5; 

NRepeat=l; 

G00D_ANSWER_ATTEMPTS=80; 

°/.year=2014; 

°/,semester=2; 


\documentclass[12pt]{article} 

°/,\usepackage{euscript} 

\usepackage{amsmath} 

\usepackage{amssymb} 

\usepackage{array} 

°/,\us epackagefgr aphi cx} 

\input /Nur/MyTexUtils/Macros.tex 

°/.\newcommand{\makeslide}{} 

\textwidth 16cm \oddsidemargin 0cm \textheight 25cm \topmargin 
-1.5cm \pagestyle{empty} 




\newcounter{nques} 

\setcounter{nques}{0} 

\newcommand{\problA} [2] {\bigskip \addtocounter{nques}{l} °/, 
\noindent \mbox{{\bf\arabic{nques}.}\,[$#2$m]}} 
\newcommand{\problB} [3] {\bigskip \addtocounter{nques}{l} °/, 
\noindent \mbox{{\bf\arabic{nques}.}\,[$#2$m,$-#3$m]}} 
\renewcommand{\theenumi}{\roman{enumi}} 
\renewcommand{\labelenumi}{(\theenumi)} 
\newcommand{\noitem} [2] {\ #2}’/. \ \margcom{\bf (#1)}} 
\newcommand{\problemtype} [1] {} ’/Amargcom{\tiny \sf (#1)}} 




mx/x/x/x/x/x/x/x/x/x/x/x/x/x/x/x/x/x/xm^^^^^^^^^ 


\newcommand{\fl}{{\it fl}} 

\renewcommand{\gcd}{\mathrm{GCD}} 

\newcommand{\lcm}{\mathrm{LCM}} 

\newcommand{\proof}{{\it Proof.} \ } 

\renewcommand{\iff}{\Leftrightarrow } 

\renewcommand{\id}{\mathrm{id}} 

\newcommand{\congn}[2]{#1 \equiv #2 \ \ (\,\mathrm{mod} \ n)} 
\newcommand{\congruent}[3]{#1 \equiv #2 \ \ (\,\mathrm{mod} \ #3)} 

y, Before \begin{document} Spike introduces three 
y, LaTeX constants: \topiccode, \topicname, \NAss. 
y. For example: 

y, \newcommand{\topicname}{Algebra} 
y, \newcommand{\topiccode}{MATH2712} 
y, \newcommand{\NAss}{l} 

\begin{document} 

\bigskip 

\newpage 

\begin{center} \large Flinders University \Year\ \ Semester \Semester \\ 
\topicname \ \topiccode \\ 

\bigskip 
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{\bf \bf Assignment \NAss \\ \today} 

\end{center} 

Please spend a few minutes to read the following text before "/, 
you submit your assignment. 

"/This may save hours of your time later. 

$\bullet$ This assignment constitutes \PercentMarks\"/ of the total "/ 
topic assessment. Hence, the mark for this assignment will be 
accordingly scaled. 

"/To solve the assignment problems you can use a calculator or MATLAB 
"/unless it is specified what to use or not to use. 

$\bullet$ This assignment is due on \underline{\DueDate. }■ 

$\bullet$ This is a multiple choice assignment and as a result only 
answers are marked. The working is not marked. 

Therefore, you need to submit only answers to questions, not the working. 

$\bullet$ You should submit your answers by email. In the subject of your 
email please give the topic code {\tt \topiccode}-, the assignment number 
{\tt A\NAss}-, your student ID and your answers in 

\underline{this order}. The topic code and the assignment number must be 
separated by only one space. 

For example, if your student ID is 2028022, then the subject line should 
look as follows: 

\begin{center} \tt 

\topiccode\ A\NAss\ 2028022 ECDCEBADCEADBC... 

\end{center} 

In this case the answer to the first question is E, 
the answer to the second question is C, euid so on. 

If you do not want to aniswer a question then put a dot or £ui X 
instead of an answer. 

Since one mistake in a string of answers may strongly alter the assignment 
mark, it is desirable that the answers from the email’s subject are 
duplicated in your e-mail. This would allow to easily settle any possible 
disputes. 

For example, in the case of answer string given above you should 
write in the email body a text which may look as follows: 

\begin{center} \tt 
Q1 E \\ 

Q2 C \\ 

Q3 D \\ 

\end{center} 

Another option is to scan and attach your working to the email. 

$\bullet$ What happens to your submission? If you submit answers to eui 
assignment correctly and in due time then 

firstly you will get an automatic notification that your submission has 
been received, secondly your submission 

gets to a special folder where it will be processed by a computer 
program. I don’t read your emails and 

the computer program which processes assignment submissions also ignores 
the email’s text. Hence, you don’t need 

to write in the email something like ‘‘Hi ...’’, but you need to duplicate 
your answers in the email body 
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to resolve possible disputes. 

$\bullet$ Your submission will be marked by a marking program. This program 
will reject your submission in any of the following cases: 

\begin{ enumerate}- 

\item There is a mistake in the topic code (-CXttXtopiccode}- for this 
assignment) or in the assignment number ({\tt A\NAss} for this assignment) 
\item The topic code and the assignment number are separated by anything 
else except one space as shown above; 

\item The student ID from the subject line does not match with student 
ID’s of any students enrolled in this topic; 

\item If the answer string which follows after the student ID contains 
any character except the following ten characters: {\tt ABCDEFGH.X}; 

\item The number of answers in the euiswer line differs from the number 
of questions in the assignment. 

\ end{ enumer at e }■ 

For example, if you are submitting an assignment \NAss\ of the topic 
{\tt\topiccode}- and this assignment contains 12 questions euid your student 
ID is {\tt 2028022} then the following subject lines are correct 
in the sense that they are not rejected by the marking program. 

\begin{center} \tt 

\topiccode\ A\NAss\ 2028022 AFECDDABCAAA \\ 

\topiccode\ A\NAss\ 2028022 AEECD.ABC..A \\ 

\topiccode\ A\NAss\ 2028022 AEBCD.ABCXEA \\ 

\end{center} 

The following are a few examples of subject lines which will be rejected 
by the marking program with explanation of why they are rejected. 

\bigskip 

{ \tt 
\noindent 

\topiccode\ \ A\NAss\ 2028022 AFECDDABCAAA 

\quad (two spaces before the assignment number) \\ 

\topiccode A\NAss\ 2028022 AFECDDABCAAA 

\quad (no space before the assignment number) \\ 

\topiccode,A\NAss\ 2028022 AFECDDABCAAA 

\quad (a comma before the assignment number) \\ 

MATH2912 A\NAss\ 2028202 AEBCD.ABCXEA \quad (wrong topic code) \\ 
\topiccode\ A9 2028022 AFECDDABCAAA \quad (wrong assignment n\imber) \\ 
\topiccode\ A\NAss\ 2028202 AEBCD.ABCXEA 
\quad (a typo in student ID) \\ 

\topiccode\ A\NAss\ 2028022 AEECDDABCCB\ \ 

\quad (incorrect number of auiswers) \\ 

\topiccode\ A\NAss\ 2028022 AEECDDABCCBEDD 

\quad (incorrect number of answers) \\ 

\topiccode\ A\NAss\ 2028022 AEECD DABCC BE 
\quad (a space in the answer line) \\ 

\topiccode\ A\NAss\ 2028022 AEECDDA, Q8 [BCC] BE 
\qquad (incorrect characters) \\ 

MATH2912 A9 2028202 AEECDDA, Q8 [BCC] BE 
\qquad (everything is incorrect:) \\ 

} 

$\bullet$ 

{\bf Copying answers of someone else or allowing someone else to copy 
your answers is a breach of academic 

integrity}. Giving hints to correct answers is also prohibited. 

{\bf By submitting this assignment you declare that answers you 
submit are your own work.} 
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$\bullet$ 

The number in square brackets after a 

question number shows the number of points which you get for a 
correct answer to this question. If this positive number in the 
square brackets is followed by a negative number, then this means 
that there is a penalty for a wrong answer to this question, the 
penalty being the second negative number; otherwise there is no 
penalty for a wrong answer. For example, [2m,$-2$m] means that you 
get two points for a correct answer, zero points for no answer and 
$-2$ points for an incorrect answer. 

$\bullet$ Each student has his/her own version of the assignment 
(with randomized numbers). You should find your assignment in this file 
using the last three digits of your student ID: 

they appear in the right top corner of each page of your assignment. 

$\bullet$ If your answer to an assignment question is different from all 
the multiple choice answers, 

and you still believe that your answer is in fact correct (which is 
unlikely but possible), then please put X instead of 
a multiple choice answer A,B,... amd give your answer in the email. 

$\bullet$ If you believe that one (or more) of the questions in your 
assignment was marked incorrectly, then you may challenge your mark. 

To challenge an assignment mark 

send me an email with the following information: topic code, assignment 
number, assignment question number, the answer which you gave and the 
correct answer which you are challenging. I’ll check your challenge and 
if it is correct, you will get your deserved mark. If your claim is 
incorrect. I’ll explain why. 

Every student is allowed to make two incorrect challenges (per topic, 
per semester). After these two incorrect challenges I reserve the right 
not to answer your claims. But unlike the tennis system, if you make a 
correct challenge, the number of challenges you have will increase by one. 

Correct challenges are very welcome, since they help to improve the system. 

$\bullet$ 

\noindent Consulting times: Tuesday, 2pm—4pm. \\ 

Venue: Tonsley T1 4.42. \\ 

My email \ \verbInurulla.azamovSflinders.edu.au! 

School of Computer Science, Engineering and Mathematigs, Flinders University, Bedford Park, 5042, SA 
Australia. 

E-mail address: nurulla.azamovOflinders.edu.au 



